std::filesystem::path::string, std::filesystem::path::wstring, std::filesystem::path::u8string, std::filesystem::path::u16string, std::filesystem::path::u32string
< cpp | filesystem | path
template< class CharT, class Traits = std::char_traits<CharT>, class Alloc = std::allocator<CharT> > |
(1) | (C++17 起) |
(2) | (C++17 起) | |
std::string string() const; |
||
std::wstring wstring() const; |
||
std::u16string u16string() const; |
||
std::u32string u32string() const; |
||
(3) | ||
std::string u8string() const; |
(C++17 起) (C++20 前) |
|
std::u8string u8string() const; |
(C++20 起) | |
返回原生路径名格式的内部路径名,转换到指定的字符串类型。若存在转换,则按下列方式进行:
- 若
path::value_type
是 char ,若转换存在,则转换是依赖系统的。这是在典型 POSIX 系统(例如 Linux )上的情形,其中原生字符编码是 UTF-8 且string()
不进行转换。 - 否则,若
path::value_type
是 wchar_t ,若转换存在,则是未指定的。这是在 Windows 上的情形,其中 wchar_t 为 16 位且原生编码为 UTF-16 。 - 否则,若
path::value_type
是 char16_t ,则原生编码是 UTF-16 而转换方法未指定。 - 否则,若
path::value_type
是 char32_t ,则原生编码是 UTF-32 而转换方法未指定。 - 否则,若
path::value_type
是 char8_t ,则原生编码是 UTF-8 而转换方法未指定。
1) 所有内存分配由
a
进行。3)
u8string()
情形的编码结果始终是 UTF-8 。参数
(无)
返回值
转换到指定字符串类型的原生路径名格式的内部路径名。
异常
(无)
示例
运行此代码
#include <cstdio> #ifdef _MSC_VER #include <io.h> #include <fcntl.h> #else #include <locale> #include <clocale> #endif #include <fstream> #include <iostream> #include <filesystem> namespace fs = std::filesystem; int main() { #ifdef _MSC_VER _setmode(_fileno(stderr), _O_WTEXT); #else std::setlocale(LC_ALL, ""); std::locale::global(std::locale("")); std::cout.imbue(std::locale()); std::wcerr.imbue(std::locale()); #endif fs::path p = fs::u8path(u8"要らない.txt"); std::ofstream(p) << "File contents"; // 在 LWG2676 前 MSVC 上使用 operator string_type() // ,其中 string_type 是 wstring ,仅根据非标准扩展工作 // LWG2676 后使用新的 fstream 构造函数 // 原生字符串表示可用于 OS API if (std::FILE* f = #ifdef _MSC_VER _wfopen(p.c_str(), L"r") #else std::fopen(p.c_str(), "r") #endif ) { int ch; while((ch=fgetc(f))!= EOF) putchar(ch); std::fclose(f); } // 多字节与宽字节表示可用于输出 std::cout << "\nFile name in narrow multibyte encoding: " << p.string() << '\n'; 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
参阅
返回转换到字符串的通用路径名格式 (公开成员函数) |