std::filesystem::path::string, std::filesystem::path::wstring, std::filesystem::path::u8string, std::filesystem::path::u16string, std::filesystem::path::u32string

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;

std::string string() const;

std::wstring wstring() const;

std::u16string u16string() const;

std::u32string u32string() const;

std::string u8string() const;

std::u8string u8string() const;

Devuelve el nombre de ruta interno en formato de ruta nativa, convertido a un tipo de cadena específico. La conversión, si la hay, se realiza de la siguiente manera:

• Si path::value_type es char, la conversión, si la hay, depende del sistema. Este es el caso en sistemas POSIX típicos (como Linux), donde la codificación nativa es UTF-8 y string() no realiza ninguna conversión.
• De lo contrario, si path::value_type es wchar_t, la conversión, si la hay, no está especificada. Este es el caso en Windows, donde wchar_t es de 16 bits y la codificación nativa es UTF-16.
• De lo contrario, si path::value_type es char16_t, la codificación nativa es UTF-16 y el método de conversión no está especificado.
• De lo contrario, si path::value_type es char32_t, la codificación nativa es UTF-32 y el método de conversión no está especificado.
• De lo contrario, si path::value_type es char8_t, la codificación nativa es UTF-8 y el método de conversión no está especificado.

Valor de retorno

La ruta interna en formato de ruta nativa, convertida al tipo de cadena especificado.

Excepciones

Puede lanzar excepciones definidas por la implementación.

Ejemplo

#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) << "File contents";
    // la representación de cadena nativa puede usarse con APIs del sistema operativo
    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);
    }
    // las representaciones multibyte y wide pueden usarse para salida
    std::cout << "\nFile name in narrow multibyte encoding: " << p.string() << '\n';
    // wstring() lanzará una excepción en stdlibc++ (según gcc-12.1.0), ver:
    // https://gcc.gnu.org/bugzilla/show_bug.cgi?id=95048
    // https://gcc.gnu.org/bugzilla/show_bug.cgi?id=102839
    // funciona con versiones más recientes gcc-12.2.1 (2023/02/01) y clang-10+
    std::wcout << "File name in wide encoding: " << p.wstring() << '\n';
    std::filesystem::remove(p);
}

File contents
File name in narrow multibyte encoding: 要らない.txt
File name in wide encoding: 要らない.txt

Véase también