std::experimental::filesystem::equivalent
来自 cppreference.com
< cpp | experimental | fs
| 定义在头文件中 <experimental/filesystem> |
||
| bool equivalent( const path& p1, const path& p2 ); bool equivalent( const path& p1, const path& p2, error_code& ec ); |
(1) | (文件系统 TS) |
检查路径 p1 和 p2 是否引用同一个文件或目录，并且通过 status (会跟随符号链接) 判断其文件状态是否相同。
如果 p1 或 p2 不存在，或者其文件类型不是文件、目录或符号链接 (通过 is_other 判断)，则会报告错误。
非抛出重载在错误时返回 false。
内容 |
[编辑] 参数
| p1, p2 | - | 要检查等效性的路径 |
| ec | - | 非抛出重载中用于错误报告的输出参数 |
[编辑] 返回值
如果 p1 和 p2 引用同一个文件或目录，并且其文件状态相同，则返回 true。 否则返回 false。
[编辑] 异常
不带 error_code& 参数的重载在底层 OS API 错误时抛出 filesystem_error，使用 p1 作为第一个参数、p2 作为第二个参数，以及 OS 错误代码作为错误代码参数构造。 std::bad_alloc 可能会在内存分配失败时抛出。 带有 error_code& 参数的重载如果 OS API 调用失败，则将其设置为 OS API 错误代码，如果未发生错误，则执行 ec.clear()。 这个重载有noexcept 规范：
noexcept
[编辑] 备注
如果两个路径的 st_dev 和 st_ino 在其 POSIX stat 结构 中相等（这意味着文件位于同一设备的相同位置），则认为这两个路径解析为同一个文件系统实体，该结构如同通过 POSIX stat 获取。
特别是，同一个文件或目录的所有硬链接都是等效的，并且同一个文件系统上的符号链接与其目标也是等效的。
[编辑] 示例
运行此代码
#include <cstdint> #include <experimental/filesystem> #include <iostream> namespace fs = std::experimental::filesystem; int main() { // hard link equivalency fs::path p1 = "."; fs::path p2 = fs::current_path(); if (fs::equivalent(p1, p2)) std::cout << p1 << " is equivalent to " << p2 << '\n'; // symlink equivalency fs::path p3 = "/lib/libc.so.6"; fs::path p4 = p3.parent_path() / fs::read_symlink(p3); if (fs::equivalent(p3, p4)) std::cout << p3 << " is equivalent to " << p4 << '\n'; }
可能的输出
"." is equivalent to "/var/tmp/test" "/lib/libc.so.6" is equivalent to "/lib/libc-2.12.so"
[编辑] 另请参阅
| 确定文件属性 确定文件属性，并检查符号链接目标 (函数) |
