phobos ~master (2024-10-03T07:50:27Z)

asAbsolutePath

std path

Transforms path into an absolute path.

The following algorithm is used:

  1. If path is empty, return null.
  2. If path is already absolute, return it.
  3. Otherwise, append path to the current working directory, which allocates memory.

Note that asAbsolutePath will not normalize .. segments. Use asNormalizedPath(asAbsolutePath(path)) if that is desired.

auto
asAbsolutePath
(
R
)
(
R path
)
if (
(
isRandomAccessRange!R &&
isSomeChar!(ElementType!R)
||
isNarrowString!R
) &&
!isConvertibleToString!R
)

Parameters

path R

the relative path to transform

Return Value

Type: auto

the transformed path as a lazy range

Examples

import std.array;
assert(asAbsolutePath(cast(string) null).array == "");
version (Posix)
{
    assert(asAbsolutePath("/foo").array == "/foo");
}
version (Windows)
{
    assert(asAbsolutePath("c:/foo").array == "c:/foo");
}
asAbsolutePath("foo");

See Also

absolutePath which returns an allocated string

Meta

Source

See Implementation

std path enumsfunctionsvariables

Page generated by adrdox