C++文件系统库

• 类
• 非成员函数
• 文件类型

此文来源于👉文件系统库 - cppreference.com，并整理。

• 库范畴定义
  • 文件：持有数据的文件系统对象，能被写入或读取，或二者皆可。文件拥有名称及属性，属性之一是文件类型：
    • 目录：表现为目录条目的容器的文件，目录条目标识其他文件（其中一些可以是另外的嵌套的目录）。讨论到具体文件时，包含该文件目录条目的目录是其父目录。父目录能以相对路径名 “..” 表示。
    • 硬链接：关联一个名字到一个既存文件的目录条目。若支持多重硬链接，则文件在最后一个到它的硬链接被移除后才被移除。
    • 符号链接：关联一个名词到一个路径的目录条目，路径可以存在亦可不存在。
    • 常规文件：不是其他文件类型的文件。
  • 文件名：命名一个文件的字符串。容许字符、大小写区别、最大长度以及被禁止名称是实现定义的。名称 “.” （点）与 “..” （双点）在库层次拥有特殊含义。
  • 路径：标识一个文件的元素序列。它以可选的 根名 （例如 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)	表示文件时间值 (typedef)

非成员函数#

定义于头文件 <filesystem>
定义于命名空间 std::filesystem
absolute(C++17)	组成一个绝对路径 (函数)
canonicalweakly_canonical(C++17)	组成一个规范路径 (函数)
relativeproximate(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(C++17)	修改文件访问权限 (函数)
read_symlink(C++17)	获得符号链接的目标 (函数)
remove remove_all(C++17)(C++17)	移除一个文件或空目录 移除一个文件或递归地移除一个目录及其所有内容 (函数)
rename(C++17)	移动或重命名一个文件或目录 (函数)
resize_file(C++17)	以截断或填充零更改一个常规文件的大小 (函数)
space(C++17)	确定文件系统上的可用空闲空间 (函数)
status symlink_status(C++17)(C++17)	确定文件属性 确定文件属性，检查符号链接目标 (函数)
temp_directory_path(C++17)	返回一个适用于临时文件的目录 (函数)

文件类型#

is_block_file(C++17)	检查给定的路径是否表示块设备 (函数)
is_character_file(C++17)	检查给定的路径是否表示字符设备 (函数)
is_directory(C++17)	检查给定的路径是否表示一个目录 (函数)
is_empty(C++17)	检查给定的路径是否表示一个空文件或空目录 (函数)
is_fifo(C++17)	检查给定的路径是否表示一个命名管道 (函数)
is_other(C++17)	检查参数是否表示一个其他文件 (函数)
is_regular_file(C++17)	检查参数是否表示一个常规文件 (函数)
is_socket(C++17)	检查参数是否表示一个具名 IPC 套接字 (函数)
is_symlink(C++17)	检查参数是否表示一个符号链接 (函数)
status_known(C++17)	检查参数是否表示一个符号链接 (函数)