std::filesystem::path::generic_string, std::filesystem::path::generic_wstring, std::filesystem::path::generic_u8string, std::filesystem::path::generic_u16string, std::filesystem::path::generic_u32string

template< class CharT, class Traits = std::char_traits<CharT>,
          class Alloc = std::allocator<CharT> >
std::basic_string<CharT,Traits,Alloc>
    generic_string( const Alloc& a = Alloc() ) const;

std::string generic_string() const;

std::wstring generic_wstring() const;

std::u16string generic_u16string() const;

std::u32string generic_u32string() const;

std::string generic_u8string() const;

std::u8string generic_u8string() const;

Renvoie le chemin interne au format de chemin générique, converti en un type de chaîne spécifique. La conversion, si elle a lieu, est spécifiée comme suit :

• Si path::value_type est char, la conversion, si elle a lieu, dépend du système. C'est le cas sur les systèmes POSIX typiques (comme Linux), où l'encodage natif est UTF-8 et string() n'effectue aucune conversion.
• Sinon, si path::value_type est wchar_t, la conversion, si elle a lieu, est non spécifiée. C'est le cas sur Windows, où wchar_t est 16 bits et l'encodage natif est UTF-16.
• Sinon, si path::value_type est char16_t, l'encodage natif est UTF-16 et la méthode de conversion est non spécifiée.
• Sinon, si path::value_type est char32_t, l'encodage natif est UTF-32 et la méthode de conversion est non spécifiée.
• Sinon, si path::value_type est char8_t, l'encodage natif est UTF-8 et la méthode de conversion est non spécifiée.

Le caractère / est utilisé comme séparateur de répertoire.

Paramètres

Valeur de retour

Le chemin interne au format générique de chemin, converti en type de chaîne spécifié.

Exceptions

Peut lever des exceptions définies par l'implémentation.

Exemple

#include <cstddef>
#include <filesystem>
#include <iomanip>
#include <iostream>
#include <span>
#include <string_view>
void print(std::string_view rem, auto const& str)
{
    std::cout << rem << std::hex << std::uppercase << std::setfill('0');
    for (const auto b : std::as_bytes(std::span{str}))
        std::cout << std::setw(2) << std::to_integer<unsigned>(b) << ' ';
    std::cout << '\n';
}
int main()
{
    std::filesystem::path p{"/家/屋"};
    std::cout << p << '\n';
    print("string    : ", p.generic_string());
    print("u8string  : ", p.generic_u8string());
    print("u16string : ", p.generic_u16string());
    print("u32string : ", p.generic_u32string());
    print("wstring   : ", p.generic_wstring());
}

"/家/屋"
string    : 2F E5 AE B6 2F E5 B1 8B
u8string  : 2F E5 AE B6 2F E5 B1 8B
u16string : 2F 00 B6 5B 2F 00 4B 5C
u32string : 2F 00 00 00 B6 5B 00 00 2F 00 00 00 4B 5C 00 00
wstring   : 2F 00 00 00 B6 5B 00 00 2F 00 00 00 4B 5C 00 00

Voir aussi