Namespaces
Variants

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

From cppreference.net
C++
Filesystem library
Classes
Functions
File types
std::filesystem::path
Member types
Member constants
Member functions
Path decomposition
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20) (C++20)
Helper classes
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 ;
(1) (depuis C++17)
(2) (depuis C++17)
std:: string generic_string ( ) const ;
std:: wstring generic_wstring ( ) const ;
std:: u16string generic_u16string ( ) const ;
std:: u32string generic_u32string ( ) const ;
(3)
std:: string generic_u8string ( ) const ;
(depuis C++17)
(jusqu'à C++20)
std:: u8string generic_u8string ( ) const ;
(depuis C++20)

Retourne le chemin interne au format générique de chemin, 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, le cas échéant, dépend du système. C'est le cas sur les systèmes POSIX typiques (tels que Linux), où l'encodage natif est UTF-8 et string() n'effectue aucune conversion.
  • Sinon, si path::value_type est wchar_t , la conversion, le cas échéant, n'est pas 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 n'est pas spécifiée.
  • Sinon, si path::value_type est char32_t , l'encodage natif est UTF-32 et la méthode de conversion n'est pas spécifiée.
  • Sinon, si path::value_type est char8_t , l'encodage natif est UTF-8 et la méthode de conversion n'est pas spécifiée.

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

1) Toutes les allocations de mémoire sont effectuées par a .
3) L'encodage du résultat dans le cas de u8string() est toujours UTF-8.

Table des matières

Paramètres

a - allocateur pour construire la chaîne
Exigences de type
-
CharT doit être l'un des types de caractères encodés ( char , wchar_t , char8_t (depuis C++20) , char16_t et char32_t ).

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

Exécuter ce code 
#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());
}

Sortie possible : 

"/家/屋"
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

retourne le chemin au format natif de nom de chemin converti en chaîne
(fonction membre publique)