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

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

Преобразует последовательность байтов в широкую строку с помощью фасета, на который указывает cvtptr .

1) Последовательность байтов состоит только из одного элемента byte.

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

3) Последовательность байтов — это последовательность, содержащаяся в str.

4) Последовательность байтов — это диапазон [first, last).

Перед началом преобразования, если объект *this был сконструирован не с помощью перегруженной версии конструктора (3), cvtstate будет установлено в значение по умолчанию (исходное состояние преобразования).

Количество успешно преобразованных входных элементов будет сохранено в cvtcount .

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

Если преобразование выполнено успешно, возвращает результат преобразования. В противном случае, если *this сконструирован с помощью перегруженной версии конструктора (4), возвращает wide_err_string.

Исключения

Если преобразование не удалось и *this был сконструирован не с помощью перегруженной версии конструктора (4), выбрасывает 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 [виртуальная]	преобразует строку из `ExternT` в `InternT`, например при чтении из файла (виртуальная защищённая функция-член класса `std::codecvt<InternT,ExternT,StateT>`)

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