std::filesystem::u8path

定义在头文件 `<filesystem>` 中
template< class Source > std::filesystem::path u8path( const Source& source );	(1)	(自 C++17 起) (在 C++20 中已弃用)
template< class InputIt > std::filesystem::path u8path( InputIt first, InputIt last );	(2)	(自 C++17 起) (在 C++20 中已弃用)

使用 UTF-8 编码的 char 序列或 char8_t 序列(自 C++20 起)，以 std::string、std::string_view、以空字符结尾的多字节字符串，或者以 [first, last) 迭代器对的形式提供，构造一个路径 p。

如果 path::value_type 是 char 并且本地编码是 UTF-8，则直接构造路径，就像使用 path(source) 或 path(first, last) 一样。注意：这是使用 Unicode 的 POSIX 系统（例如 Linux）的典型情况。
否则，如果 path::value_type 是 wchar_t 并且本地编码是 UTF-16（这是 Windows 上的情况），或者如果 path::value_type 是 char16_t（本地编码保证为 UTF-16）或 char32_t（本地编码保证为 UTF-32），则首先将 UTF-8 字符序列转换为类型为 path::string_type 的临时字符串 tmp，然后像使用 path(tmp) 一样构造新路径。
否则（对于非 UTF-8 窄字符编码，以及对于非 UTF-16 wchar_t），首先将 UTF-8 字符序列转换为类型为 std::u32string 的 UTF-32 编码的临时字符串 tmp，然后像使用 path(tmp) 一样构造新路径（这是在使用非 Unicode 多字节或单字节编码文件系统的 POSIX 系统上执行的操作）。

[编辑] 参数

source	-	UTF-8 编码的 std::string、std::string_view、指向以空字符结尾的多字节字符串的指针，或者字符值为 char 的输入迭代器，指向以空字符结尾的多字节字符串
first, last	-	指定 UTF-8 编码字符序列的 LegacyInputIterators 对
类型要求
- `InputIt` 必须满足 LegacyInputIterator 的要求。
- `Source` 或 `InputIt` 的值类型必须是 char 或 char8_t.(自 C++20 起)

[编辑] 返回值

从输入字符串（在从 UTF-8 转换为文件系统的本地字符编码后）构造的路径。

[编辑] 异常

如果内存分配失败，可能会抛出 std::bad_alloc。

[编辑] 备注

在本地路径格式与通用路径格式不同的系统上（Windows 或 POSIX 系统都不是此类操作系统的示例），如果此函数的参数使用通用格式，它将被转换为本地格式。

[编辑] 示例

运行此代码

#include <cstdio>
#ifdef _MSC_VER
#include <fcntl.h>
#include <io.h>
#else
#include <clocale>
#include <locale>
#endif
#include <filesystem>
#include <fstream>
 
int main()
{
#ifdef _MSC_VER
    _setmode(_fileno(stderr), _O_WTEXT);
#else
    std::setlocale(LC_ALL, "");
    std::locale::global(std::locale(""));
#endif
 
    std::filesystem::path p(u8"要らない.txt");
    std::ofstream(p) << "File contents"; // Prior to LWG2676 uses operator string_type()
                                         // on MSVC, where string_type is wstring, only
                                         // works due to non-standard extension.
                                         // Post-LWG2676 uses new fstream constructors
 
    // Native string representation can be used with OS-specific APIs
#ifdef _MSC_VER
    if (std::FILE* f = _wfopen(p.c_str(), L"r"))
#else
    if (std::FILE* f = std::fopen(p.c_str(), "r"))
#endif
    {
        for (int ch; (ch = fgetc(f)) != EOF; std::putchar(ch))
        {}
        std::fclose(f);
    }
 
    std::filesystem::remove(p);
}

可能的输出

File contents

[编辑] 另请参阅

path

(C++17)

表示一个路径
(类) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作