文件系统库

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 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	表示文件时间值 (typedef)

非成员函数

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)