std::filesystem::path::lexically_normal、std::filesystem::path::lexically_relative、std::filesystem::path::lexically_proximate
来自 cppreference.cn
< cpp | filesystem | path
| path lexically_normal() const; |
(1) | (自 C++17 起) |
| path lexically_relative( const path& base ) const; |
(2) | (自 C++17 起) |
| path lexically_proximate( const path& base ) const; |
(3) | (自 C++17 起) |
2) 返回相对于 base 的 *this。
- 首先，如果 root_name() != base.root_name() 为 true，或者 is_absolute() != base.is_absolute() 为 true，或者 (!has_root_directory() && base.has_root_directory()) 为 true，或者 relative_path() 或 base.relative_path() 中的任何文件名可以解释为 root-name，则返回默认构造的路径。
- 否则，首先确定 *this 和 base 的第一个不匹配元素，如同通过 auto [a, b] = mismatch(begin(), end(), base.begin(), base.end())，然后
- 如果 a == end() 且 b == base.end()，则返回 path(".")，
- 否则，将 N 定义为 [b, base.end()) 中既不是 dot 也不是 dot-dot 的非空文件名元素的数量，减去 dot-dot 文件名元素的数量。如果 N < 0，则返回默认构造的路径，
- 否则，如果 N = 0 且 a == end() || a->empty()，则返回 path(".")，
- 否则，返回由以下内容组成的对象：
- 后跟默认构造的 path()
- N 次 operator/=(path("..")) 应用，后跟
- 对于半开区间
[a,end())中的每个元素，应用一次 operator/=。
3) 如果 lexically_relative(base) 的值不是空路径，则返回它。否则返回 *this。
内容 |
[编辑] 参数
(无)
[编辑] 返回值
1) 路径的规范形式。
2) 路径的相对形式。
3) 路径的邻近形式。
[编辑] 异常
可能会抛出实现定义的异常。
[编辑] 注释
这些转换纯粹是词法的。它们不检查路径是否存在，不跟踪符号链接，并且完全不访问文件系统。对于 lexically_relative 和 lexically_proximate 的符号链接跟踪对应项，请参见 relative 和 proximate。
在 Windows 上，返回的 path 具有反斜杠（首选分隔符）。
在 POSIX 上，相对路径中的任何文件名都不能接受为 root-name。
[编辑] 示例
运行此代码
#include <cassert> #include <filesystem> #include <iostream> namespace fs = std::filesystem; int main() { assert(fs::path("a/./b/..").lexically_normal() == "a/"); assert(fs::path("a/.///b/../").lexically_normal() == "a/"); assert(fs::path("/a/d").lexically_relative("/a/b/c") == "../../d"); assert(fs::path("/a/b/c").lexically_relative("/a/d") == "../b/c"); assert(fs::path("a/b/c").lexically_relative("a") == "b/c"); assert(fs::path("a/b/c").lexically_relative("a/b/c/x/y") == "../.."); assert(fs::path("a/b/c").lexically_relative("a/b/c") == "."); assert(fs::path("a/b").lexically_relative("c/d") == "../../a/b"); assert(fs::path("a/b").lexically_relative("/a/b") == ""); assert(fs::path("a/b").lexically_proximate("/a/b") == "a/b"); }
[编辑] 缺陷报告
以下行为变更缺陷报告已追溯应用于先前发布的 C++ 标准。
| DR | 应用于 | 已发布行为 | 正确行为 |
|---|---|---|---|
| LWG 3070 | C++17 | 也可能是 root-name 的文件名可能导致意外结果 | 视为错误情况 |
| LWG 3096 | C++17 | 尾随 "/" 和 "/." 处理不正确 | 已修正 |
[编辑] 参见
| (C++17) |
构成相对路径 (函数) |
