std::filesystem::path::compare
来自 cppreference.com
< cpp | filesystem | path
| int compare( const path& p ) const noexcept; |
(1) | (自 C++17) |
| int compare( const string_type& str ) const; int compare( std::basic_string_view<value_type> str ) const; |
(2) | (自 C++17) |
| int compare( const value_type* s ) const; |
(3) | (自 C++17) |
比较路径和另一个路径的词法表示。
1) 如果 root_name().native().compare(p.root_name().native()) 不为零，则返回该值。
否则，如果 has_root_directory() != p.has_root_directory()，则如果
has_root_directory() 为 false，则返回小于零的值，否则返回大于零的值。 否则，如果路径的相对部分 (
relative_path()) 在词法上分别小于、等于或大于 p (p.relative_path()) 的相对部分，则返回小于、等于或大于 0 的值。比较是逐元素进行的，就像通过迭代路径从 begin() 到 end() 并比较每个元素的 native() 结果一样。2) 等效于 compare(path(str)).
3) 等效于 compare(path(s)).
内容 |
[编辑] 参数
| p | - | 要比较的路径 |
| str | - | 表示要比较的路径的字符串或字符串视图 |
| s | - | 表示要比较的路径的以空字符结尾的字符串 |
[编辑] 返回值
如果路径在词法上小于给定的路径，则返回小于 0 的值。
如果路径在词法上等于给定的路径，则返回等于 0 的值。
如果路径在词法上大于给定的路径，则返回大于 0 的值。
[编辑] 异常
2,3) 可能会引发实现定义的异常。
[编辑] 注释
对于双向比较，二元运算符 可能更合适。
[编辑] 示例
运行此代码
#include <filesystem> #include <iostream> #include <string_view> namespace fs = std::filesystem; void demo(fs::path p1, fs::path p2, std::string_view msg) { std::cout << p1; const int rc = p1.compare(p2); if (rc < 0) std::cout << " < "; else if (rc > 0) std::cout << " > "; else std::cout << " == "; std::cout << p2 << " \t: " << msg << '\n'; } int main() { demo("/a/b/", "/a/b/", "simple"); demo("/a/b/", "/a/b/c", "simple"); demo("/a/b/../b", "/a/b", "no canonical conversion"); demo("/a/b", "/a/b/.", "no canonical conversion"); demo("/a/b/", "a/c", "absolute paths order after relative ones"); }
输出
"/a/b/" == "/a/b/" : simple "/a/b/" < "/a/b/c" : simple "/a/b/../b" > "/a/b" : no canonical conversion "/a/b" < "/a/b/." : no canonical conversion "/a/b/" > "a/c" : absolute paths order after relative ones
[编辑] 缺陷报告
以下改变行为的缺陷报告被追溯应用于之前发布的 C++ 标准。
| DR | 应用于 | 已发布的行为 | 正确行为 |
|---|---|---|---|
| LWG 2936 | C++17 | 直接比较所有路径元素 | 分别处理根名称和根目录 |
[编辑] 另请参阅
| (C++17)(C++17)(until C++20)(C++17)(until C++20)(C++17)(until C++20)(C++17)(until C++20)(C++17)(until C++20)(C++20) |
词法比较两个路径 (函数) |
