Filesystem library

已并入 ISO C++ 标准 本页面描述的功能已于 2016 年 3 月并入 ISO C++ 主线标准；请参阅 文件系统库 (自 C++17 起)

文件系统库（ISO/IEC TS 18822:2015）提供了对文件系统及其组件（如路径、常规文件和目录）执行操作的功能设施。

该库是一个可选的 技术规范 ，若实现无法访问分层文件系统，或未提供必要能力时可能不可用。若底层文件系统不支持某些特性（例如FAT文件系统没有硬链接、软链接及其他特性），则部分功能可能无法使用。

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

本库直接基于 boost.filesystem ，该库目前在比此实验性技术规范更多的编译器和平台上可用。

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

库级定义

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

• 目录 ：作为目录条目容器的文件，这些条目标识其他文件（其中一些可能是其他嵌套目录）。在讨论特定文件时，它作为条目出现的目录称为其 父目录 。父目录可通过相对路径名 ".." 表示。
• 硬链接 ：将名称与现有文件关联的目录条目。若支持多硬链接，文件将在最后一个指向它的硬链接被删除后移除。
• 符号链接 ：将名称与路径关联的目录条目，该路径可能存在也可能不存在。
• 常规文件 ：不属于其他文件类型的文件。

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

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

类

path	表示路径 (类)
filesystem_error	文件系统错误时抛出的异常 (类)
directory_entry	目录项 (类)
directory_iterator	目录内容的迭代器 (类)
recursive_directory_iterator	目录及其子目录内容的迭代器 (类)
file_status	表示文件类型和权限 (类)
space_info	文件系统可用空间信息 (类)
file_type	文件类型 (枚举)
perms	标识文件系统权限 (枚举)
copy_options	指定复制操作语义 (枚举)
directory_options	目录内容遍历选项 (枚举)
file_time_type	表示文件时间值 (类型定义)

非成员函数

absolute system_complete	组合绝对路径 将路径转换为绝对路径并复制操作系统特定行为 (函数)
canonical	组合规范路径 (函数)
copy	复制文件或目录 (函数)
copy_file	复制文件内容 (函数)
copy_symlink	复制符号链接 （函数）
create_directory create_directories	创建新目录 (函数)
create_hard_link	创建硬链接 （函数）
create_symlink create_directory_symlink	创建符号链接 (函数)
current_path	返回当前工作目录 (函数)
exists	检查路径是否指向存在的文件系统对象 (函数)
equivalent	检查两个路径是否指向同一文件系统对象 (函数)
file_size	返回文件大小 （函数）
hard_link_count	返回指向特定文件的硬链接数量 (函数)
last_write_time	获取或设置最后数据修改时间 (函数)
permissions	修改文件访问权限 (函数)
read_symlink	获取符号链接的目标路径 （函数）
remove remove_all	删除文件或空目录 递归删除文件或目录及其所有内容 (函数)
rename	移动或重命名文件或目录 (函数)
resize_file	通过截断或零填充方式修改常规文件的大小 (函数)
space	确定文件系统上的可用空闲空间 (函数)
status symlink_status	确定文件属性 确定文件属性，检查符号链接目标 (函数)
temp_directory_path	返回适用于临时文件的目录 (函数)
文件类型
is_block_file	检查给定路径是否指向块设备 (函数)
is_character_file	检查给定路径是否指向字符设备 (函数)
is_directory	检查给定路径是否指向目录 (函数)
is_empty	检查给定路径是否指向空文件或目录 (函数)
is_fifo	检查给定路径是否指向命名管道 (函数)
is_other	检查参数是否指向 其他 文件 （函数）
is_regular_file	检查参数是否指向常规文件 (函数)
is_socket	检查参数是否指向命名IPC套接字 (函数)
is_symlink	检查参数是否指向符号链接 (函数)
status_known	检查文件状态是否已知 (函数)

另请参阅

C++ 文档 关于 文件系统库 (C++17)