View source code Display the source code in std/path.d from which this page was generated on github. Improve this page Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone. Page wiki View or edit the community-maintained wiki page associated with this page.

Function std.path.defaultExtension

Prototype

immutable(Unqual!C1)[] defaultExtension(C1, C2)(
  C1[] path,
  C2[] ext
)
if (isSomeChar!C1 && is(Unqual!C1 == Unqual!C2));

Parameters

NameDescription
path A path name.
ext The default extension to use.

Returns

The path given by path, with the extension given by ext appended if the path doesn't already have one.

Including the dot in the extension is optional.

This function always allocates a new string, except in the case when path is immutable and already has an extension.

Examples

assert (defaultExtension("file", "ext")      == "file.ext");
assert (defaultExtension("file", ".ext")     == "file.ext");
assert (defaultExtension("file.", "ext")     == "file.");
assert (defaultExtension("file.old", "new")  == "file.old");
assert (defaultExtension("file.old", ".new") == "file.old");

Authors

Lars Tandle Kyllingstad, Walter Bright, Grzegorz Adam Hankiewicz, Thomas Kühne, Andrei Alexandrescu

License

Boost License 1.0

Comments