std::experimental::filesystem::absolute, std::experimental::filesystem::system_complete
来自 cppreference.cn
< cpp | experimental | fs
| 定义于头文件 <experimental/filesystem> |
||
| path absolute( const path& p, const path& base = current_path() ); |
(1) | (filesystem TS) |
| path system_complete( const path& p ); path system_complete( const path& p, error_code& ec ); |
(2) | (filesystem TS) |
1) 根据下列规则，返回相对于 base 的 p 的绝对路径
- 如果 p 既有根名称又有根目录（例如 "C:\users"），则返回路径，不作修改。
- 如果 p 有根名称但后面没有根目录（例如 "C:text.txt"），则在 p 的根名称和 p 的其余部分之间插入 base。形式上，返回 p.root_name() / fs::absolute(base).root_directory() / fs::absolute(base).relative_path() / p.relative_path() ，
- 如果 p 没有根名称，但有根目录（例如 POSIX 系统上的 "/var/tmp/file.txt" 或 Windows 上的 "\users\ABC\Document.doc"），则将 base 的根名称（如果存在）添加到 p 的前面（在 POSIX 系统上，p 不会被修改；在 Windows 系统上，"\users\ABC\Document.doc" 变为 "C:\users\ABC\Document.doc"）。形式上，返回 fs::absolute(base).root_name() / p。
- 如果 p 没有根名称也没有根目录（例如 "../file.txt"），则将整个 base 添加到 p 的前面。形式上，返回 absolute(base) / p。
2) 获取绝对路径，该路径标识 OS 文件打开 API 将根据路径名 p 访问的文件。在 POSIX 系统上，这等效于默认 base (
fs::current_path()) 的 (1)。在 Windows 系统上，每个逻辑驱动器都有自己的当前工作目录，因此，如果 p 尚不是绝对路径并且具有根名称组件（例如 "E:filename.txt"），则使用该驱动器的当前工作目录，该目录可能是由先前执行的程序设置的。内容 |
[编辑] 参数
| p | - | 要转换为绝对形式的路径 |
| base | - | 用作起始位置的路径（不一定是绝对路径） |
| ec | - | 用于在非抛出重载中报告错误的输出参数 |
[编辑] 返回值
返回通过组合 p 和 base 以上述方式形成的绝对路径（尽管不一定是规范路径）。
[编辑] 异常
不接受 error_code& 参数的重载会在底层 OS API 错误时抛出 filesystem_error，并使用 p 作为第一个参数，base 作为第二个参数，以及 OS 错误代码作为错误代码参数构造。如果内存分配失败，则可能抛出 std::bad_alloc。接受 error_code& 参数的重载会在 OS API 调用失败时将其设置为 OS API 错误代码，如果未发生错误，则执行 ec.clear()。此重载具有noexcept 规范：
noexcept
[编辑] 注解
在支持根名称的系统（例如 Windows）上，对具有根名称的相对路径（例如，当 base 的根名称不同时，"D:file.txt"）调用 absolute 通常会导致不存在的路径。
[编辑] 示例
运行此代码
#include <filesystem> #include <iostream> namespace fs = std::experimental::filesystem; int main() { fs::path p = "C:cl.exe"; std::cout << "Current path is " << fs::current_path() << '\n' << "Absolute path for " << p << " is " << fs::absolute(p) << '\n' << "System complete path for " << p << " is " << fs::system_complete(p) << '\n'; }
可能的输出
Current path is "D:/local/ConsoleApplication1" Absolute path for "C:cl.exe" is "C:/local/ConsoleApplication1/cl.exe" System complete path for "C:cl.exe" is "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\cl.exe"
[编辑] 参见
| 构成规范路径 (函数) |
