std::filesystem::absolute - cppreference.com (original) (raw)

Defined in header
path absolute( const std::filesystem::path& p );	(1)	(since C++17)
path absolute( const std::filesystem::path& p, std::error_code& ec );	(2)	(since C++17)

Returns a path referencing the same file system location as p, for which filesystem::path::is_absolute() is true.

This non-throwing overload returns default-constructed path if an error occurs.

[edit] Parameters

p	-	path to convert to absolute form
ec	-	out-parameter for error reporting in the non-throwing overload

[edit] Return value

Returns an absolute (although not necessarily canonical) pathname referencing the same file as p.

[edit] Exceptions

Any overload not marked noexcept may throw std::bad_alloc if memory allocation fails.

Throws std::filesystem::filesystem_error on underlying OS API errors, constructed with p as the first path argument and the OS error code as the error code argument.
Sets a std::error_code& parameter to the OS API error code if an OS API call fails, and executes ec.clear() if no errors occur.

[edit] Notes

Implementations are encouraged to not consider p not existing to be an error.

For POSIX-based operating systems, std::filesystem::absolute(p) is equivalent to std::filesystem::current_path() / p except for when p is the empty path.

For Windows, std::filesystem::absolute may be implemented as a call to GetFullPathNameW.

[edit] Example

Possible output: