文件系统库

 

C++

编译器支持

独立和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

实验性的

技术规范

文件系统库 (filesystem TS)

库基础 (library fundamentals TS)

库基础 2 (library fundamentals TS v2)

库基础 3 (library fundamentals TS v3)

并行扩展 (parallelism TS)

并行扩展 2 (parallelism TS v2)

并发扩展 (concurrency TS)

并发扩展 2 (concurrency TS v2)

概念 (concepts TS)

范围 (ranges TS)

反射 (reflection TS)

数学特殊函数 (special functions TR)

实验性非 TS

模式匹配

线性代数

std::execution

契约式设计

2D 图形

 

文件系统库

类
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator filesystem::file_status	filesystem::space_info filesystem::file_type filesystem::perms filesystem::copy_options filesystem::directory_options filesystem::file_time_type
函数
filesystem::absolute filesystem::system_complete filesystem::canonical filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path filesystem::exists filesystem::equivalent	filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status filesystem::temp_directory_path
文件类型
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

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

此库是可选的技术规范，如果实现无法访问分层文件系统，或者如果它不提供必要的功能，则可能不可用。 如果底层文件系统不支持某些功能（例如 FAT 文件系统没有硬链接、软链接和其他功能），则这些功能可能不可用。

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

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

库范围定义

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

• 目录：一种充当目录项容器的文件，目录项标识其他文件（其中一些可能是其他嵌套目录）。在讨论特定文件时，该文件作为条目出现的目录是其父目录。父目录可以用相对路径名 ".." 表示。
• 硬链接：将名称与现有文件关联的目录项。如果支持多个硬链接，则在该文件的最后一个硬链接被删除后，该文件将被删除。
• 符号链接：将名称与路径关联的目录项，该路径可能存在也可能不存在。
• 常规文件：不是其他文件类型之一的文件。

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

• 绝对路径：明确标识文件位置的路径。
• 规范路径：不包含符号链接、"." 或 ".." 元素的绝对路径。
• 相对路径：标识相对于文件系统上某个位置的文件的路径。 特殊路径名 . （点，“当前目录”）和 .. （点-点，“父目录”）是相对路径。

类

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

非成员函数

absolutesystem_complete	组合绝对路径 将路径转换为绝对路径，复制操作系统特定的行为 (函数)
canonical	组合规范路径 (函数)
copy	复制文件或目录 (函数)
copy_file	复制文件内容 (函数)
copy_symlink	复制符号链接 (函数)
create_directorycreate_directories	创建新目录 (函数)
create_hard_link	创建硬链接 (函数)
create_symlinkcreate_directory_symlink	创建符号链接 (函数)
current_path	返回当前工作目录 (函数)
exists	检查路径是否引用现有的文件系统对象 (函数)
equivalent	检查两个路径是否引用相同的文件系统对象 (函数)
file_size	返回文件的大小 (函数)
hard_link_count	返回引用特定文件的硬链接数 (函数)
last_write_time	获取或设置上次数据修改的时间 (函数)
permissions	修改文件访问权限 (函数)
read_symlink	获取符号链接的目标 (函数)
removeremove_all	删除文件或空目录 删除文件或目录及其所有内容，递归地 (函数)
rename	移动或重命名文件或目录 (函数)
resize_file	通过截断或零填充更改常规文件的大小 (函数)
space	确定文件系统上的可用空间 (函数)
statussymlink_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)