Filesystem library (since C++17)

文件系统库提供了对文件系统及其组件（如路径、常规文件和目录）执行操作的功能。

文件系统库最初作为 boost.filesystem 开发，后发布为 技术规范 ISO/IEC TS 18822:2015 ，并最终随 C++17 并入 ISO C++ 标准。目前 boost 实现在更多编译器和平台上的可用性仍优于 C++17 标准库。

文件系统库功能在以下情况下可能不可用：若实现无法访问分层文件系统，或该文件系统未提供必要能力。某些特性在底层文件系统不支持时可能无法使用（例如FAT文件系统缺乏符号链接并禁止多重硬链接）。这些情况下必须报错。

若对此库中函数的调用引入了 文件系统竞争 （即多个线程、进程或计算机交错访问和修改文件系统中的同一对象），则该行为是 未定义 的。

目录 1 库级定义 2 类 3 非成员函数 3.1 文件类型 4 备注 5 参见

库级定义

• file ：一种文件系统对象，用于存储数据，可进行写入、读取或读写操作。文件具有名称和属性，其中文件类型是属性之一：

• directory ：作为目录条目容器的文件，这些条目标识其他文件（其中一些可能是其他嵌套目录）。在讨论特定文件时，其作为条目出现的目录称为其 父目录 。父目录可通过相对路径名 ".." 表示。
• regular file ：将名称与现有文件关联的目录条目（即 硬链接 ）。若支持多重硬链接，文件将在最后一个硬链接被移除后删除。
• symbolic link ：将名称与路径关联的目录条目，该路径可能存在也可能不存在。
• 其他特殊文件类型： block 、 character 、 fifo 、 socket 。

• 文件名 : 用于命名文件的字符串。允许使用的字符、大小写敏感性、最大长度以及禁止使用的名称由实现定义。名称 "." （点）和 ".." （点点）在库级别具有特殊含义。
• 路径 : 用于标识文件的一系列元素。它以可选的 根名称 （例如 Windows 上的 "C:" 或 "//server" ）开头，后跟可选的 根目录 （例如 Unix 上的 "/" ），然后是零个或多个文件名序列（除最后一个外，其余都必须是目录或目录链接）。路径的字符串表示形式（即 路径名 ）的本机格式（例如使用哪些字符作为分隔符）和字符编码由实现定义，此库提供路径的可移植表示形式。

• 绝对路径 : 能够明确标识文件位置的路径。
• 规范路径 : 不包含符号链接、 "." 或 ".." 元素的绝对路径。
• 相对路径 : 相对于文件系统中某个位置来标识文件位置的路径。特殊路径名称 "." （点号，"当前目录"）和 ".." （双点号，"父目录"）属于相对路径。

类
定义于头文件 <filesystem>
定义于命名空间 std::filesystem
path (C++17)	表示路径 (类)
filesystem_error (C++17)	文件系统错误时抛出的异常 (类)
directory_entry (C++17)	目录项 (类)
directory_iterator (C++17)	目录内容的迭代器 (类)
recursive_directory_iterator (C++17)	目录及其子目录内容的迭代器 (类)
file_status (C++17)	表示文件类型和权限 (类)
space_info (C++17)	文件系统可用空间信息 (类)
file_type (C++17)	文件类型 (枚举)
perms (C++17)	标识文件系统权限 (枚举)
perm_options (C++17)	指定权限操作的语义 (枚举)
copy_options (C++17)	指定复制操作的语义 (枚举)
directory_options (C++17)	目录遍历选项 (枚举)
file_time_type (C++17)	表示文件时间值 (类型定义)
非成员函数
定义于头文件 <filesystem>
定义于命名空间 std::filesystem
absolute (C++17)	组合绝对路径 (函数)
canonical weakly_canonical (C++17)	组合规范路径 (函数)
relative proximate (C++17)	组合相对路径 (函数)
copy (C++17)	复制文件或目录 (函数)
copy_file (C++17)	复制文件内容 (函数)
copy_symlink (C++17)	复制符号链接 (函数)
create_directory create_directories (C++17) (C++17)	创建新目录 (函数)
create_hard_link (C++17)	创建硬链接 (函数)
create_symlink create_directory_symlink (C++17) (C++17)	创建符号链接 (函数)
current_path (C++17)	返回或设置当前工作目录 (函数)
exists (C++17)	检查路径是否指向存在的文件系统对象 (函数)
equivalent (C++17)	检查两个路径是否指向同一文件系统对象 (函数)
file_size (C++17)	返回文件大小 (函数)
hard_link_count (C++17)	返回指向特定文件的硬链接数 (函数)
last_write_time (C++17)	获取或设置最后数据修改时间 (函数)
permissions <span class

注释

使用此库可能需要额外的编译器/链接器选项。GNU 9.1 之前的实现需要链接 -lstdc++fs ，LLVM 9.0 之前的实现需要链接 -lc++fs 。

功能测试 宏	值	标准	功能
__cpp_lib_filesystem	201703L	(C++17)	文件系统库

参见

C++ 文档 关于 File System TS