30
Input/output library
[input.output]
30.10
File systems
[filesystems]
30.10.15
Filesystem operation functions
[fs.op.funcs]
30.10.15.1
Absolute
[fs.op.absolute]
path absolute(const path& p); path absolute(const path& p, error_code& ec);
1
#
Effects:
Composes an absolute path referencing the same file system location as
p
according to the operating system (
[fs.conform.os]
)
.
2
#
Returns:
The composed path
.
The signature with argument
ec
returns
path()
if an error occurs
.
3
#
[
Note
:
For the returned path,
rp
,
rp.is_absolute()
is
true
unless an error occurs
.
—
end note
]
4
#
Throws:
As specified in
[fs.err.report]
.
5
#
[
Note
:
To resolve symlinks, or perform other sanitization which might require queries to secondary storage, such as hard disks, consider
canonical
(
[fs.op.canonical]
)
.
—
end note
]
6
#
[
Note
:
Implementations are strongly encouraged to not query secondary storage, and not consider
!exists(p)
an error
.
—
end note
]
7
#
[
Example
:
For POSIX-based operating systems,
absolute(p)
is simply
current_path()/p
.
For Windows-based operating systems,
absolute
might have the same semantics as
GetFullPathNameW
.
—
end example
]