# 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> > 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 <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

### 参阅

generic_string generic_wstring generic_u8string generic_u16string generic_u32string | 返回转换到字符串的通用路径名格式 (公开成员函数)