std::experimental::filesystem::u8path
来自 cppreference.com
< cpp | experimental | fs | path
| 定义在头文件 <experimental/filesystem> 中 |
||
| template< class Source > path u8path( const Source& source ); |
(1) | (文件系统 TS) |
| template< class InputIt > path u8path( InputIt first, InputIt last ); |
(2) | (文件系统 TS) |
从 UTF-8 编码的 char 序列构造路径 p，可以作为 std::string，或作为空终止多字节字符串，或作为 [first, last] 迭代器对提供。
- 如果
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，指向空终止多字节字符串的指针，或具有 char 值类型的输入迭代器，指向空终止多字节字符串 |
| first, last | - | 指定 UTF-8 编码字符序列的 LegacyInputIterators 对 |
| 类型要求 | ||
-InputIt 必须满足 LegacyInputIterator 的要求。 | ||
-InputIt 的值类型必须是 char。 | ||
[编辑] 返回值
从输入字符串构造的路径，在从 UTF-8 转换为文件系统的本机字符编码后。
[编辑] 异常
可能会在底层操作系统 API 错误时抛出 filesystem_error，或在内存分配失败时抛出 std::bad_alloc。
[编辑] 注释
在本机路径格式与通用路径格式不同的系统上（Windows 或 POSIX 系统都不是此类操作系统的示例），如果此函数的参数使用通用格式，它将被转换为本机格式。
[编辑] 示例
运行此代码
#include <clocale> #include <cstdio> #include <experimental/filesystem> #include <fstream> #include <iostream> namespace fs = std::experimental::filesystem; int main() { std::setlocale(LC_ALL, "en_US.utf8"); std::locale::global(std::locale("en_US.utf8")); fs::path p = fs::u8path(u8"要らない.txt"); // native string representation can be used with OS APIs std::ofstream(p) << "File contents"; // this uses operator string() if (std::FILE* f = std::fopen(p.c_str(), "r")) { int ch; while ((ch=fgetc(f))!= EOF) putchar(ch); std::fclose(f); } // multibyte and wide representation can be used for output std::cout.imbue(std::locale()); std::cout << "\nFile name in narrow multibyte encoding: " << p.string() << '\n'; std::wcerr.imbue(std::locale()); std::wcerr << "File name in wide encoding: " << p.wstring() << '\n'; fs::remove(p); }
可能的输出
File contents File name in narrow multibyte encoding: 要らない.txt File name in wide encoding: 要らない.txt
[编辑] 参见
| 表示路径 (类) |
