std::experimental::filesystem::create_symlink, std::experimental::filesystem::create_directory_symlink
来自 cppreference.cn
< cpp | experimental | fs
定义于头文件 <experimental/filesystem> |
||
void create_symlink( const path& target, const path& link ); void create_symlink( const path& target, const path& link, error_code& ec ); |
(1) | (文件系统 TS) |
void create_directory_symlink( const path& target, const path& link ); void create_directory_symlink( const path& target, const path& link, error_code& ec ); |
(2) | (文件系统 TS) |
创建一个符号链接 link,其目标设置为 target,如同通过 POSIX symlink():路径名 target 可能无效或不存在。
某些操作系统要求符号链接创建时识别链接是否为目录。可移植代码应使用 (2) 创建目录符号链接,而不是 (1),尽管在 POSIX 系统上没有区别。
目录 |
[编辑] 参数
target | - | 符号链接指向的路径,无需存在 |
link | - | 新符号链接的路径 |
ec | - | 非抛出重载中用于错误报告的出参 |
[编辑] 返回值
(无)
[编辑] 异常
不带 error_code& 参数的重载会在底层 OS API 错误时抛出 filesystem_error,该错误使用 target 作为第一个参数,link 作为第二个参数,OS 错误码作为错误码参数构造。如果内存分配失败,可能会抛出 std::bad_alloc。带 error_code& 参数的重载在 OS API 调用失败时将其设置为 OS API 错误码,并且在没有错误发生时执行 ec.clear()。此重载具有noexcept 规范:
noexcept
[编辑] 注意
某些操作系统根本不支持符号链接,或者只支持常规文件的符号链接。
某些文件系统不支持符号链接,无论操作系统如何,例如某些存储卡和闪存驱动器上使用的 FAT 系统。
像硬链接一样,符号链接允许文件拥有多个逻辑名称。硬链接的存在保证了文件的存在,即使原始名称已被删除。符号链接不提供此类保证;事实上,当创建链接时,target 参数指定的文件不一定存在。符号链接可以跨越文件系统边界。
[编辑] 示例
运行此代码
#include <experimental/filesystem> #include <iostream> namespace fs = std::experimental::filesystem; int main() { fs::create_directories("sandbox/subdir"); fs::create_symlink("target", "sandbox/sym1"); fs::create_directory_symlink("subdir", "sandbox/sym2"); for (auto it = fs::directory_iterator("sandbox"); it != fs::directory_iterator(); ++it) if (is_symlink(it->symlink_status())) std::cout << *it << "->" << read_symlink(*it) << '\n'; fs::remove_all("sandbox"); }
可能的输出
"sandbox/sym1"->"target" "sandbox/sym2"->"subdir"
[编辑] 参阅
确定文件属性 确定文件属性,检查符号链接目标 (函数) | |
获取符号链接的目标 (函数) | |
创建硬链接 (函数) |