类型

定义

value_type

文件系统原生编码所用的字符类型：

POSIX 上为 char，Windows 上为 wchar_t

string_type

std::basic_string<value_type>

const_iterator

value_type 为 path 的常量老式输入迭代器 (LegacyInputIterator) ，符合老式双向迭代器 (LegacyBidirectionalIterator) 的所有要求，但对于两个相等且可解引用的 const_iterator 类型的迭代器 a 与 b，不要求 *a 与 b 指代同一对象。const_iterator 是否实际为[老式双向迭代器* (LegacyBidirectionalIterator) ](https://zh.cppreference.com/w/cpp/named_req/BidirectionalIterator)是未指定的。

iterator

const_iterator 的别名

format

确定如何解读路径名的字符串表示亦定义下列枚举项：

常量解释

native_format原生路径格式

generic_format通用路径格式

auto_format实现定义格式，如果可能就自动检测 (枚举)

constexpr

value_type

preferred_separator

[static]

在可移植的 / 之外可用的另一种目录分隔符。

Windows 上它是反斜杠字符 \。

POSIX 上它是与可移植分隔符相同的斜杠 /

(公开静态成员常量)

(构造函数)

构造一个 path (公开成员函数)

(析构函数)

销毁 path 对象 (公开成员函数)

operator=

赋值另一个路径 (公开成员函数)

assign

赋值内容 (公开成员函数)

连接

append

operator/=

以目录分隔符向路径添加元素 (公开成员函数)

concat

operator+=

连接两个路径而不加入目录分隔符 (公开成员函数)

修改器

clear

擦除内容 (公开成员函数)

make_preferred

转换目录分隔符为首选目录分隔符 (公开成员函数)

remove_filename

移除文件名路径组分 (公开成员函数)

replace_filename

以另一路径替换最末的路径组分 (公开成员函数)

replace_extension

替换扩展名 (公开成员函数)

swap

交换两个路径 (公开成员函数)

格式观察器

c_str

native

operator

string_type

返回路径的原生版本 (公开成员函数)

string

wstring

u8string

u16string

u32string

返回转换到字符串的原生路径名格式的路径 (公开成员函数)

generic_string

generic_wstring

generic_u8string

generic_u16string

generic_u32string

返回转换到字符串的通用路径名格式 (公开成员函数)

比较

compare

以字典序比较两个路径的词法表示 (公开成员函数)

生成

lexically_normal

lexically_relative

lexically_proximate

转换路径到正常形式 转换路径到相对形式 转换路径到近似形式 (公开成员函数)

分解

root_name

若存在则返回路径的根名 (公开成员函数)

root_directory

若存在则返回路径的根目录 (公开成员函数)

root_path

若存在则返回路径的根路径 (公开成员函数)

relative_path

返回相对根路径的路径 (公开成员函数)

parent_path

返回父路径的路径 (公开成员函数)

filename

返回文件名路径组分 (公开成员函数)

stem

返回主干路径组分（不带扩展名的文件名） (公开成员函数)

extension

返回文件扩展名路径组分 (公开成员函数)

查询

empty

检查路径是否为空 (公开成员函数)

has_root_path

has_root_name

has_root_directory

has_relative_path

has_parent_path

has_filename

has_stem

has_extension

检查对应路径元素是否非空 (公开成员函数)

is_absoluteis_relative

检查 root_path() 是否唯一标识文件系统位置 (公开成员函数)

迭代器

beginend

将路径作为元素序列访问的迭代器 (公开成员函数)

swap(std::filesystem::path)

交换两个路径 (函数)

hash_value

计算路径对象的散列值 (函数)

operator==

operator!=(C++20 前)

operator<(C++20 前)

operator<=(C++20 前)

operator>(C++20 前)

operator>=(C++20 前)

operator<=>(C++20)

以字典序比较两个路径 (函数)

operator/

用目录分隔符连接两个路径 (函数)

operator<>

进行路径上的流输入及输出 (函数)

u8path(C++17)

(C++20 中弃用)

从 UTF-8 编码的源创建 path (函数)

在命名空间 std 定义

std::hash(C++17)

std::filesystem::path 的散列支持 (类模板特化)

path() noexcept;

(1)

(C++17 起)

path( const path& p );

(2)

(C++17 起)

path( path&& p ) noexcept;

(3)

(C++17 起)

path( string_type&& source, format fmt = auto_format );

(4)

(C++17 起)

template< class Source > path( const Source& source, format fmt = auto_format );

(5)

(C++17 起)

template< class InputIt > path( InputIt first, InputIt last, format fmt = auto_format );

(6)

(C++17 起)

template< class Source > path( const Source& source, const std::locale& loc, format fmt = auto_format );

(7)

(C++17 起)

template< class InputIt > path( InputIt first, InputIt last, const std::locale& loc, format fmt = auto_format );

(8)

(C++17 起)

若源字符类型是 char8_t，则使用从 UTF-8 到原生文件系统编码的转换。

(C++20 起)

p

要复制的路径

source

std::basic_string，std::basic_string_view，指向空终止字符串的指针，或拥有字符值类型并指向空终止字符序列的的输入迭代器（对于重载 (7) 字符类型必须是 char）

first, last

一对指定字符序列的老式输入迭代器 (LegacyInputIterator)

fmt

path::format 类型的枚举项，指定路径名格式如何转译

loc

定义编码转换所用的本地环境

类型要求

-InputIt 必须满足老式输入迭代器 (LegacyInputIterator) 。

-InputIt 的值类型

必须是字符类型

char、

char8_t (C++20 起)、

wchar_t、

char16_t

及 char32_t 之一，

以使用重载 (6)。

-InputIt 的值类型必须是 char，以使用 (8)。

关于从 Unicode 字符串生成可移植路径名，见 u8path。

(C++20 前)

源为 char8_t 的序列时，path 构造函数支持从 UTF-8 字符串创建。

(C++20 起)