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

Defined in header `<locale>`
wide_string from_bytes( char byte );	(1)
wide_string from_bytes( const char* ptr );	(2)
wide_string from_bytes( const byte_string& str );	(3)
wide_string from_bytes( const char* first, const char* last );	(4)

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

1) Преобразует byte как будто это строка длиной 1 в wide_string.

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

3) Преобразует узкую строку str в wide_string.

4) Преобразует многобайтовую последовательность символов [first, last) в wide_string.

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

Результат

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

Исключения

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

Пример

#include <codecvt>
#include <cstdint>
#include <iostream>
#include <locale>
#include <string>
 
int main()
{
    std::string utf8 = "z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                 // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
 
    // the UTF-8 / UTF-16 standard conversion facet
    std::u16string utf16 = std::wstring_convert<
        std::codecvt_utf8_utf16<char16_t>, char16_t>{}.from_bytes(utf8.data());
    std::cout << "UTF-16 conversion produced " << utf16.size()
              << " code units: " << std::showbase;
    for (char16_t c : utf16)
        std::cout << std::hex << static_cast<std::uint16_t>(c) << ' ';
 
    // the UTF-8 / UTF-32 standard conversion facet
    std::u32string utf32 = std::wstring_convert<
        std::codecvt_utf8<char32_t>, char32_t>{}.from_bytes(utf8);
    std::cout << "\nUTF-32 conversion produced " << std::dec
              << utf32.size() << " code units: ";
    for (char32_t c : utf32)
        std::cout << std::hex << static_cast<std::uint32_t>(c) << ' ';
    std::cout << '\n';
}

Вывод:

UTF-16 conversion produced 5 code units: 0x7a 0xdf 0x6c34 0xd834 0xdd0b
UTF-32 conversion produced 4 code units: 0x7a 0xdf 0x6c34 0x1d10b

См. также

to_bytes	преобразует строку широких символов в строку байтов (публичный член-функция)
mbsrtowcs	преобразует узкую многобайтовую строку символов в строку широких символов, учитывая состояние (функция)
do_in [virtual]	преобразует строку из `ExternT` в `InternT`, например, при чтении из файла (виртуальная защищенная функция-член класса `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/from_bytes