std::filesystem::path::string, std::filesystem::path::wstring, std::filesystem::path::u8string, std::filesystem::path::u16string, std::filesystem::path::u32string
来自cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num t-dcl-rev-notes t-since-cxx17 ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
template< class CharT, class Traits = std::char_traits<CharT>, class Alloc = std::allocator<CharT> > std::basic_string<CharT,Traits,Alloc> string( const Alloc& a = Alloc() ) const; |
(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 <clocale>
#include <cstdio>
#include <filesystem>
#include <fstream>
#include <iostream>
#include <locale>
int main()
{
const char* const localeName = "ja_JP.utf-8";
std::setlocale(LC_ALL, localeName);
std::locale::global(std::locale(localeName));
const std::filesystem::path p(u8"要らない.txt");
std::ofstream(p) << "文件内容";
// 原生字符串表示可以用于 OS API
if (std::FILE* const f = std::fopen(p.string().c_str(), "r"))
{
for (int ch; (ch = std::fgetc(f)) != EOF;)
std::putchar(ch);
std::fclose(f);
}
// 多字节和宽表示可以用于输出
std::cout << "\n窄多字节编码的文件名: " << p.string() << '\n';
// stdlibc++ 的 wstring() 会抛出异常（见于 gcc-12.1.0），参见
// https://gcc.gnu.org/bugzilla/show_bug.cgi?id=95048
// https://gcc.gnu.org/bugzilla/show_bug.cgi?id=102839
// 更新的 gcc-12.2.1 (2023/02/01) 和 clang-10+ 中可以工作
std::wcout << "宽编码的文件名: " << p.wstring() << '\n';
std::filesystem::remove(p);
}
可能的输出：
文件内容
窄多字节编码的文件名: 要らない.txt
宽编码的文件名: 要らない.txt
参阅
| 返回转换到字符串的通用路径名格式 (公开成员函数) |