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) | (文件系统 TS) |
| path system_complete( const path& p ); path system_complete( const path& p, error_code& ec ); |
(2) | (文件系统 TS) |
1) 根据以下规则返回相对于 base 的 p 的绝对路径
- 如果 p 既有根名又有根目录（例如 "C:\users"），则返回原路径，不作修改。
- 如果 p 有根名但没有根目录（例如 "C:text.txt"），则将 base 插入到 p 的根名和 p 的其余部分之间。形式上，返回 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 系统上，这等同于 (1) 使用默认的 base（
fs::current_path()）。在 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）的系统上，对具有根名的相对路径（例如 "D:file.txt"，当 base 的根名不同时）调用 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"
[编辑] 参阅
| 组成一个规范路径 (函数) |
