baseName

auto baseName(R path)
auto baseName(C[] path)
inout(C)[] baseName(inout(C)[] path, C1[] suffix)
@safe pure
inout(C)[]
baseName
(
CaseSensitive cs = CaseSensitive.osDefault
C
C1
)
(
return scope inout(C)[] path
,
in C1[] suffix
)
if (
isSomeChar!C &&
isSomeChar!C1
)

Parameters

cs: Whether or not suffix matching is case-sensitive.
path inout(C)[]: A path name. It can be a string, or any random-access range of characters.
suffix C1[]: An optional suffix to be removed from the file name.

Return Value

Type: inout(C)[]

The name of the file in the path name, without any leading directory and with an optional suffix chopped off.

If suffix is specified, it will be compared to path using filenameCmp!cs, where cs is an optional template parameter determining whether the comparison is case sensitive or not. See the filenameCmp documentation for details.

Note: This function only strips away the specified suffix, which doesn't necessarily have to represent an extension. To remove the extension from a path, regardless of what the extension is, use stripExtension. To obtain the filename without leading directories and without an extension, combine the functions like this:

assert(baseName(stripExtension("dir/file.ext")) == "file");

Examples

assert(baseName("dir/file.ext") == "file.ext");
assert(baseName("dir/file.ext", ".ext") == "file");
assert(baseName("dir/file.ext", ".xyz") == "file.ext");
assert(baseName("dir/filename", "name") == "file");
assert(baseName("dir/subdir/") == "subdir");

version (Windows)
{
    assert(baseName(`d:file.ext`) == "file.ext");
    assert(baseName(`d:\dir\file.ext`) == "file.ext");
}

baseName

Parameters

Return Value

Examples

Meta

Source

Standards