std::experimental::filesystem::canonical

< cpp‎ | experimental‎ | fs

在标头 `<experimental/filesystem>` 定义
path canonical( const path& p, const path& base = current_path() );	(1)	(文件系统 TS)
path canonical( const path& p, error_code& ec );	(2)	(文件系统 TS)
path canonical( const path& p, const path& base, error_code& ec );	(3)	(文件系统 TS)

转换路径 p 为规范绝对路径，即没有点、点点元素或符号链接的绝对路径。

若 p 不是绝对路径，则函数表现为如同将其通过 absolute(p, base)（或对于 (2) 为 absolute(p)）先变成绝对路径。

路径 p 必须存在。

参数

p	-	可以绝对也可以相对于 base 的路径，但其必须为既存路径
base	-	用在 p 为相对路径情况中的基础路径
ec	-	用于存储错误状态的错误码

返回值

被解析为与 absolute(p, base)（或对于 (2) 为 absolute(p)）相同的文件的绝对路径。

异常

不接受 error_code& 形参的重载，在发生底层 OS API 错误时抛出 filesystem_error，它以 p 为第一实参，以 base 为第二实参，并以 OS 错误码为错误码实参构造。如果内存分配失败，则可抛出 std::bad_alloc。接受 error_code& 形参的重载，当 OS API 调用失败时将之设置为 OS API 错误码，而未发生错误时执行 ec.clear()。此重载具有

noexcept 规定：

noexcept

此函数模仿 POSIX realpath。

示例

#include <experimental/filesystem>
#include <iostream>
namespace fs = std::experimental::filesystem;
 
int main()
{
    fs::path p = fs::path("..") / ".." / "AppData";
    std::cout << "当前路径为 " << fs::current_path() << '\n'
              << p << " 的规范路径为 " << fs::canonical(p) << '\n';
}

可能的输出：

当前路径为 "C:\Users\abcdef\AppData\Local\Temp"
"..\..\AppData" 的规范路径为 "C:\Users\abcdef\AppData"

参阅

path	表示一个路径 (类)
absolutesystem_complete	组成一个绝对路径转换路径为绝对路径，复现 OS 特定的行为 (函数)