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

Определено в заголовке `<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)

Выполняет преобразование из широких символов в многобайтовые, используя предоставленный при создании объект codecvt.

1) Преобразует wchar так, как если бы это была строка длиной 1, в byte_string.

2) Преобразует последовательность широких символов с нулевым завершением, начинающуюся с широкого символа, на который указывает wptr, в byte_string.

3) Преобразует широкую строку wstr в byte_string.

4) Преобразует последовательность широких символов [first, last) в byte_string.

Во всех случаях преобразование начинается в начальном сдвиговом состоянии, если в конструктор этого wstring_convert объекта не было передано состояние, отличное от начального. Количество преобразованных символов и конечное значение состояния преобразования запоминаются и могут быть получены с помощью state() и converted().

Возвращаемое значение

Объект byte_string, содержащий результаты преобразования из широких символов в многобайтовые. Если преобразование завершилось неудачно и в конструктор этого wstring_convert объекта был передан строка ошибки, возвращается эта строка.

Исключение

Если объект wstring_convert был создан без строки ошибки пользователя, при неудачном преобразовании генерируется исключение std::range_error.

Пример

#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);
}

Вывод:

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

См. также

from_bytes	преобразует строку байтов в широкую строку (публичный член-функция)
wcsrtombs	преобразует широкую строку в узкую строку многобайтовых символов, учитывая состояние (функция)
do_out [virtual]	преобразует строку из `InternT` в `ExternT`, например, при записи в файл (виртуальная защищенная функция-член `std::codecvt<InternT,ExternT,StateT>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/locale/wstring_convert/to_bytes