cppreference.net

Namespaces

Page

Variants

std:: codecvt_utf8_utf16

From cppreference.net

< cpp ‎ | locale

Определено в заголовочном файле `<codecvt>`
template < class Elem, unsigned long Maxcode = 0x10ffff , std:: codecvt_mode Mode = ( std:: codecvt_mode ) 0 > class codecvt_utf8_utf16 : public std:: codecvt < Elem, char , std:: mbstate_t > ;		(начиная с C++11) (устарело в C++17) (удалено в C++26)

std::codecvt_utf8_utf16 является фасетом std::codecvt , который инкапсулирует преобразование между строкой байтов в кодировке UTF-8 и строкой символов в кодировке UTF-16. Если Elem является 32-битным типом, одна кодовая единица UTF-16 будет храниться в каждом 32-битном символе выходной последовательности.

Это фасет преобразования N:M и не может использоваться с std::basic_filebuf (который допускает только преобразования 1:N, такие как UTF-32/UTF-8, между внутренней и внешней кодировками). Этот фасет может использоваться с std::wstring_convert .

Содержание

Параметры Шаблона

Elem	-	либо char16_t , char32_t , или wchar_t
Maxcode	-	наибольшее значение `Elem` , которое этот фасет будет читать или записывать без ошибки
Mode	-	константа типа std::codecvt_mode

Функции-члены

(constructor)	создает новый `codecvt_utf8_utf16` фацет (публичная функция-член)
(destructor)	уничтожает `codecvt_utf8_utf16` фацет (публичная функция-член)

std::codecvt_utf8_utf16:: codecvt_utf8_utf16

explicit codecvt_utf8_utf16 ( std:: size_t refs = 0 ) ;

Создает новый объект std::codecvt_utf8_utf16 фацета, передает начальное значение счетчика ссылок refs базовому классу.

Параметры

refs

-

количество ссылок, связывающих фацет

std::codecvt_utf8_utf16:: ~codecvt_utf8_utf16

~codecvt_utf8_utf16 ( ) ;

Уничтожает фацет. В отличие от фацетов, управляемых локалью, деструктор этого фацета является публичным.

Унаследовано от std:: codecvt

Вложенные типы

Тип	Определение
`intern_type`	`internT`
`extern_type`	`externT`
`state_type`	`stateT`

Члены данных

Участник	Описание
std::locale::id `id` [static]	идентификатор аспекта

Функции-члены

out	вызывает `do_out` (публичная функция-член `std::codecvt<InternT,ExternT,StateT>` )
in	вызывает `do_in` (публичная функция-член `std::codecvt<InternT,ExternT,StateT>` )
unshift	вызывает `do_unshift` (публичная функция-член `std::codecvt<InternT,ExternT,StateT>` )
encoding	вызывает `do_encoding` (публичная функция-член `std::codecvt<InternT,ExternT,StateT>` )
always_noconv	вызывает `do_always_noconv` (публичная функция-член `std::codecvt<InternT,ExternT,StateT>` )
length	вызывает `do_length` (публичная функция-член `std::codecvt<InternT,ExternT,StateT>` )
max_length	вызывает `do_max_length` (публичная функция-член `std::codecvt<InternT,ExternT,StateT>` )

Защищенные функции-члены

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

Унаследовано от std:: codecvt_base

Вложенный тип	Определение
enum result { ok, partial, error, noconv } ;	Неограниченный тип перечисления

Константа перечисления	Определение
`ok`	преобразование завершено без ошибок
`partial`	не все исходные символы были преобразованы
`error`	встречен недопустимый символ
`noconv`	преобразование не требуется, входной и выходной типы совпадают

Пример

Запустить этот код

#include <cassert>
#include <codecvt>
#include <cstdint>
#include <iostream>
#include <locale>
#include <string>
int main()
{
    std::string u8 = "z\u00df\u6c34\U0001f34c";
    std::u16string u16 = u"z\u00df\u6c34\U0001f34c";
    // UTF-8 в UTF-16/char16_t
    std::u16string u16_conv = std::wstring_convert<
        std::codecvt_utf8_utf16<char16_t>, char16_t>{}.from_bytes(u8);
    assert(u16 == u16_conv);
    std::cout << "Преобразование UTF-8 в UTF-16 дало " << u16_conv.size()
              << " кодовых единиц:\n" << std::showbase << std::hex;
    for (char16_t c : u16_conv)
        std::cout << static_cast<std::uint16_t>(c) << ' ';
    // UTF-16/char16_t в UTF-8
    std::string u8_conv = std::wstring_convert<
        std::codecvt_utf8_utf16<char16_t>, char16_t>{}.to_bytes(u16);
    assert(u8 == u8_conv);
    std::cout << "\nПреобразование UTF-16 в UTF-8 дало "
              << std::dec << u8_conv.size() << " байт:\n" << std::hex;
    for (char c : u8_conv)
        std::cout << +static_cast<unsigned char>(c) << ' ';
    std::cout << '\n';
}

Вывод:

UTF-8 to UTF-16 conversion produced 5 code units:
0x7a 0xdf 0x6c34 0xd83c 0xdf4c
UTF-16 to UTF-8 conversion produced 10 bytes:
0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Applied to	Behavior as published	Correct behavior
LWG 2229	C++98	конструктор и деструктор не были определены	определяет их

Смотрите также

Преобразования символов	локале-определённые многобайтовые (UTF-8, GB18030)	UTF-8	UTF-16
UTF-16	`mbrtoc16` / `c16rtomb` (с DR488 C11)	`codecvt` < char16_t , char ,mbstate_t > `codecvt_utf8_utf16` < char16_t > `codecvt_utf8_utf16` < char32_t > `codecvt_utf8_utf16` < wchar_t >	Н/Д
UCS-2	`c16rtomb` (без DR488 C11)	`codecvt_utf8` < char16_t >	`codecvt_utf16` < char16_t >
UTF-32	`mbrtoc32` / `c32rtomb`	`codecvt` < char32_t , char ,mbstate_t > `codecvt_utf8` < char32_t >	`codecvt_utf16` < char32_t >
системный wchar_t : UTF-32 (не-Windows) UCS-2 (Windows)	`mbsrtowcs` / `wcsrtombs` `use_facet` < `codecvt` < wchar_t , char ,mbstate_t >> ( `locale` )	`codecvt_utf8` < wchar_t >	`codecvt_utf16` < wchar_t >

codecvt	преобразует между кодировками символов, включая UTF-8, UTF-16, UTF-32 (шаблон класса)
codecvt_mode (C++11) (устарело в C++17) (удалено в C++26)	флаги для изменения поведения стандартных фацетов codecvt (перечисление)
codecvt_utf8 (C++11) (устарело в C++17) (удалено в C++26)	преобразует между UTF-8 и UCS-2/UCS-4 (шаблон класса)
codecvt_utf16 (C++11) (устарело в C++17) (удалено в C++26)	преобразует между UTF-16 и UCS-2/UCS-4 (шаблон класса)