| Classes | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| File types | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <filesystem> | ||
path absolute(conststd::filesystem::path& p); | (1) | (since C++17) |
path absolute(conststd::filesystem::path& p,std::error_code& ec); | (2) | (since C++17) |
Returns a path referencing the same file system location asp, for whichfilesystem::path::is_absolute() istrue.
Contents |
| p | - | path to convert to absolute form |
| ec | - | out-parameter for error reporting in the non-throwing overload |
Returns an absolute (although not necessarily canonical) pathname referencing the same file asp.
Any overload not markednoexcept may throwstd::bad_alloc if memory allocation fails.
Implementations are encouraged to not considerp not existing to be an error.
For POSIX-based operating systems,std::filesystem::absolute(p) is equivalent tostd::filesystem::current_path()/ p except for whenp is the empty path.
For Windows,std::filesystem::absolute may be implemented as a call toGetFullPathNameW.
#include <filesystem>#include <iostream>namespace fs= std::filesystem; int main(){std::filesystem::path p="foo.c";std::cout<<"Current path is "<<std::filesystem::current_path()<<'\n';std::cout<<"Absolute path for "<< p<<" is "<< fs::absolute(p)<<'\n';}
Possible output:
Current path is "/tmp/1666297965.0051296"Absolute path for "foo.c" is "/tmp/1666297965.0051296/foo.c"
(C++17) | composes a canonical path (function)[edit] |
(C++17) | composes a relative path (function)[edit] |