Namespaces
Variants

std::wstring_convert<Codecvt,Elem,Wide_alloc,Byte_alloc>:: to_bytes

From cppreference.net
Défini dans l'en-tête <locale>
byte_string to_bytes ( Elem wchar ) ;
(1)
byte_string to_bytes ( const Elem * wptr ) ;
(2)
byte_string to_bytes ( const wide_string & wstr ) ;
(3)
byte_string to_bytes ( const Elem * first, const Elem * last ) ;
(4)

Convertit une séquence large en une chaîne d'octets en utilisant le facet pointé par cvtptr .

1) La séquence large ne contient qu'un seul élément byte .
2) La séquence large est la séquence terminée par un caractère nul commençant à ptr .
3) La séquence large est la séquence contenue dans str .
4) La séquence étendue est l'intervalle [ first , last ) .

Avant que la conversion ne commence, si * this n'a pas été construit avec la surcharge de constructeur (3) , cvtstate sera défini sur sa valeur par défaut (l'état de conversion initial).

Le nombre d'éléments d'entrée convertis avec succès sera stocké dans cvtcount .

Table des matières

Valeur de retour

Si la conversion réussit, retourne le résultat de la conversion. Sinon, si * this est construit avec le constructeur de surcharge (4) , retourne byte_err_string .

Exceptions

Si la conversion échoue et que * this n'a pas été construit avec la surcharge de constructeur (4) , lève std::range_error .

Exemple

#include <codecvt>
#include <iomanip>
#include <iostream>
#include <locale>
#include <string>
// utility function for output
void hex_print(const std::string& s)
{
    std::cout << std::hex << std::setfill('0');
    for (unsigned char c : s)
        std::cout << std::setw(2) << static_cast<int>(c) << ' ';
    std::cout << std::dec << '\n';
}
int main()
{
    // wide character data
    std::wstring wstr = L"z\u00df\u6c34\U0001f34c"; // or L"zß水🍌"
    // wide to UTF-8
    std::wstring_convert<std::codecvt_utf8<wchar_t>> conv1;
    std::string u8str = conv1.to_bytes(wstr);
    std::cout << "UTF-8 conversion produced " << u8str.size() << " bytes:\n";
    hex_print(u8str);
    // wide to UTF-16le
    std::wstring_convert<std::codecvt_utf16<wchar_t, 0x10ffff, std::little_endian>> conv2;
    std::string u16str = conv2.to_bytes(wstr);
    std::cout << "UTF-16le conversion produced " << u16str.size() << " bytes:\n";
    hex_print(u16str);
}

Sortie :

UTF-8 conversion produced 10 bytes:
7a c3 9f e6 b0 b4 f0 9f 8d 8c 
UTF-16le conversion produced 10 bytes:
7a 00 df 00 34 6c 3c d8 4c df

Voir aussi

convertit une chaîne d'octets en chaîne large
(fonction membre publique)
convertit une chaîne large en chaîne de caractères multioctets étroite, avec état donné
(fonction)
[virtual]
convertit une chaîne de InternT vers ExternT , par exemple lors de l'écriture dans un fichier
(fonction membre protégée virtuelle de std::codecvt<InternT,ExternT,StateT> )