std::experimental::filesystem::equivalent
来自 cppreference.cn
< 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) | (filesystem TS) |
检查路径 p1 和 p2 是否指向相同的文件或目录，并具有与 status 确定的相同的文件状态（符号链接会被跟随）。
如果 p1 或 p2 不存在，或者它们的文件类型不是文件、目录或符号链接（由 is_other 确定），则会报告错误。
非抛出重载在错误时返回 false。
目录 |
[编辑] 参数
| p1, p2 | - | 要检查等价性的路径 |
| ec | - | 非抛出重载中用于错误报告的输出参数 |
[编辑] 返回值
true 如果 p1 和 p2 指向相同的文件或目录，并且它们的文件状态相同。否则为 false。
[编辑] 异常
不接受 error_code& 参数的重载会在底层操作系统 API 错误时抛出 filesystem_error，它使用 p1 作为第一个参数，p2 作为第二个参数，以及操作系统错误代码作为错误代码参数构造。如果内存分配失败，可能会抛出 std::bad_alloc。接受 error_code& 参数的重载会在操作系统 API 调用失败时将其设置为操作系统 API 错误代码，并且如果没有错误发生，则执行 ec.clear()。此重载具有noexcept 规范：
noexcept
[编辑] 注解
如果通过 POSIX stat 获得的 POSIX stat 结构的 st_dev 和 st_ino 相等（意味着文件位于同一设备上的相同位置），则认为两个路径解析为相同的文件系统实体。
特别是，同一文件或目录的所有硬链接都是等价的，并且同一文件系统上的符号链接及其目标也是等价的。
[编辑] 示例
运行此代码
#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"
[编辑] 参见
| 确定文件属性 确定文件属性，检查符号链接目标 (函数) |
