std:: formatter <std::filesystem::path>

std::formatter<std::filesystem::path>:: set_debug_format

允许当前对象将路径名格式化为 转义字符串 。

std::formatter<std::filesystem::path>:: parse

将格式说明符解析为 路径格式规范 ，并将解析后的说明符存储在当前对象中。

返回指向 路径格式规范 末尾之后位置的迭代器。

std::formatter<std::filesystem::path>:: format

令 s 为：若使用 g 选项则为 p. generic < std :: filesystem :: path :: value_type > ( ) ，否则为 p. native ( ) 。按照 path-format-spec 的规范将 s 写入 ctx. out ( ) 。

关于路径名的字符转码：

• 在以下情况下，路径名会从宽字符串的本机编码转码为 UTF-8，并将非法子序列的最大子部分替换为 U+FFFD 替换字符：
  • std:: is_same_v < CharT, char > 为 true ，
  • std:: is_same_v < typename path :: value_type , wchar_t > 为 true ，且
  • 普通字面量编码 为 UTF-8。
• 若 std:: is_same_v < typename path :: value_type , CharT > 为 true ，则不执行转码。
• 其他情况下，转码行为由实现定义。

返回指向输出范围末尾的迭代器。