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