命名空间
变体
操作

std::filesystem::create_hard_link

来自 cppreference.cn
 
C++
 
文件系统库
类
函数
文件类型
 
定义于头文件 <filesystem>
void create_hard_link( const std::filesystem::path& target,
                       const std::filesystem::path& link );
 (1) (C++17 起)
void create_hard_link( const std::filesystem::path& target,

                       const std::filesystem::path& link,

                       std::error_code& ec ) noexcept;
 (2) (C++17 起)

创建一个硬链接 link，其目标设置为 target，如同 POSIX link()：路径名 target 必须存在。

创建后，link 和 target 是指同一文件的两个逻辑名称（它们是 等价的）。即使原始名称 target 被删除，该文件仍然存在并可以通过 link 访问。

目录

[编辑] 参数

target - 要链接到的文件或目录的路径
link - 新硬链接的路径
ec - 非抛出重载中用于错误报告的出参

[编辑] 返回值

(无)

[编辑] 异常

任何未标记为 noexcept 的重载都可能在内存分配失败时抛出 std::bad_alloc。

1) 在底层 OS API 错误时抛出 std::filesystem::filesystem_error，构造时以 target 作为第一个路径参数，link 作为第二个路径参数，以及 OS 错误码作为错误码参数。
2) 如果 OS API 调用失败，则将 std::error_code& 参数设置为 OS API 错误码；如果未发生错误，则执行 ec.clear()。

[编辑] 注意

某些操作系统根本不支持硬链接，或仅支持常规文件的硬链接。

某些文件系统无论操作系统如何都不支持硬链接：例如，用于存储卡和闪存驱动器的 FAT 文件系统。

某些文件系统限制每个文件的链接数量。

通常只有超级用户才能对目录进行硬链接。

硬链接通常不能跨越文件系统边界。

特殊路径名点（"."）是其父目录的硬链接。特殊路径名点点（".."）是其父目录的父目录的硬链接。

[编辑] 示例

运行此代码
#include <filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::filesystem;
 
int main()
{
    fs::create_directories("sandbox/subdir");
    std::ofstream("sandbox/a").put('a'); // create regular file
    fs::create_hard_link("sandbox/a", "sandbox/b");
    fs::remove("sandbox/a");
    // read from the original file via surviving hard link
    char c = std::ifstream("sandbox/b").get();
    std::cout << c << '\n';
    fs::remove_all("sandbox");
}

输出

a

[编辑] 参阅

(C++17)(C++17)
 创建符号链接
(函数) [编辑]
(C++17)
 返回引用特定文件的硬链接数量
(函数) [编辑]
取自“https://cppreference.cn/mwiki/index.php?title=cpp/filesystem/create_hard_link&oldid=157949”