Пространства имён
Варианты
Действия

std::codecvt_utf8_utf16

Материал из cppreference.com
< 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>;
std::codecvt_utf8_utf16 является std::codecvt аспект, который инкапсулирует преобразования между UTF-8 строку в кодировке байт и UTF-16 строка в кодировке символов Если Elem является 32... - битного типа, один UTF-16 кодовых точек будут храниться в каждом 32-разрядных характер выходной последовательности. codecvt Этот аспект может быть использован для чтения и записи UTF-8 файлов, как текстовых, так и двоичных.
Оригинал:
std::codecvt_utf8_utf16 is a std::codecvt facet which encapsulates conversion between a UTF-8 encoded byte string and UTF-16 encoded character string. If Elem is a 32-bit type, one UTF-16 codepoint will be stored in each 32-bit character of the output sequence. This codecvt facet can be used to read and write UTF-8 files, both text and binary.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Содержание

[править] Параметры шаблона

Elem -
либо char16_t, char32_t, или wchar_t
Оригинал:
either char16_t, char32_t, or wchar_t
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Maxcode -
Наибольшее значение Elem, что данный аспект будет читать и писать без ошибок
Оригинал:
the largest value of Elem that this facet will read or write without error
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Mode -
константа типа std::codecvt_mode
Оригинал:
a constant of type std::codecvt_mode
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Member types

Член типа
Оригинал:
Member type
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Definition
intern_type internT
extern_type externT
state_type stateT

Member objects

Имя пользователя
Оригинал:
Member name
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Type
id (статическим) std::locale::id

Member functions

Вызывает do_out
Оригинал:
invokes do_out
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-член std::codecvt) [edit]
Вызывает do_in
Оригинал:
invokes do_in
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-член std::codecvt) [edit]
Вызывает do_unshift
Оригинал:
invokes do_unshift
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-член std::codecvt) [edit]
Вызывает do_encoding
Оригинал:
invokes do_encoding
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-член std::codecvt) [edit]
Вызывает do_always_noconv
Оригинал:
invokes do_always_noconv
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-член std::codecvt) [edit]
Вызывает do_length
Оригинал:
invokes do_length
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-член std::codecvt) [edit]
Вызывает do_max_length
Оригинал:
invokes do_max_length
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-член std::codecvt) [edit]

Protected member functions

[virtual]
преобразует строку из internT в externT, например, при записи в файл
Оригинал:
converts a string from internT to externT, such as when writing to file
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]
[virtual]
преобразует строку из externT в internT, например, при чтении из файла
Оригинал:
converts a string from externT to internT, such as when reading from file
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]
[virtual]
генерирует последовательность прекращения характер externT символов для неполного преобразования
Оригинал:
generates the termination character sequence of externT characters for incomplete conversion
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]
[virtual]
возвращает количество externT символы, необходимые для производства одной internT характер, если постоянная
Оригинал:
returns the number of externT characters necessary to produce one internT character, if constant
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]
Тесты, если грань кодирует тождественное преобразование для всех допустимых значений аргумента
Оригинал:
tests if the facet encodes an identity conversion for all valid argument values
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]
[virtual]
вычисляет длину externT строку, которая будет потребляться преобразования в данной internT буфера
Оригинал:
calculates the length of the externT string that would be consumed by conversion into given internT buffer
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]
возвращает максимальное число externT символы, которые могут быть преобразованы в единый internT характер
Оригинал:
returns the maximum number of externT characters that could be converted into a single internT character
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]


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

Член типа
Оригинал:
Member type
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Definition
enum result { ok, partial, error, noconv };
Незаданной типа перечисления
Оригинал:
Unscoped enumeration type
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Перечисление постоянно
Оригинал:
Enumeration constant
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Definition
ok
Преобразование была завершена без ошибок
Оригинал:
conversion was completed with no error
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
partial
Не все символы источником были преобразованы
Оригинал:
not all source characters were converted
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
error
встречается недопустимый символ
Оригинал:
encountered an invalid character
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
noconv
преобразование не требуется, вход и выход типов одинаковы
Оригинал:
no conversion required, input and output types are the same
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

[править] Пример

Следующий пример демонстрирует чтение UTF -8 файл в кодировке UTF-16 строка в системе с 32-битной wchar_t
Оригинал:
The following example demonstrates reading a UTF-8 file into a UTF-16 string on a system with 32-bit wchar_t
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

#include <fstream>
#include <iostream>
#include <string>
#include <locale>
#include <codecvt>
int main()
{
    std::ofstream("text.txt") << u8"z\u6c34\U0001d10b";
 
    std::wifstream file1("text.txt");
    file1.imbue(std::locale("en_US.UTF8"));
    std::cout << "Normal read from file (using default UTF-8/UTF-32 codecvt)\n";
    for(wchar_t c; file1 >> c; )
        std::cout << std::hex << std::showbase << c << '\n';
 
    std::wifstream file2("text.txt");
    file2.imbue(std::locale(file2.getloc(), new std::codecvt_utf8_utf16<wchar_t>));
    std::cout << "UTF-16 read from the same file (using codecvt_utf8_utf16)\n";
    for(wchar_t c; file2 >> c; )
        std::cout << std::hex << std::showbase << c << '\n';
}

Вывод:

Normal read from file (using default UTF-8/UTF-32 codecvt)
0x7a
0x6c34
0x1d10b
UTF-16 read from the same file (using codecvt_utf8_utf16)
0x7a
0x6c34
0xd834
0xdd0b

[править] См. также

Character
conversions
narrow multibyte
(char)
UTF-8
(char)
UTF-16
(char16_t)
UTF-16 mbrtoc16 / c16rtomb codecvt<char16_t, char, mbstate_t>
codecvt_utf8_utf16<char16_t>
codecvt_utf8_utf16<char32_t>
codecvt_utf8_utf16<wchar_t>
N/A
UCS2 Нет codecvt_utf8<char16_t> codecvt_utf16<char16_t>
UTF-32/UCS4
(char32_t)
mbrtoc32 / c32rtomb codecvt<char32_t, char, mbstate_t>
codecvt_utf8<char32_t>
codecvt_utf16<char32_t>
UCS2/UCS4
(wchar_t)
Нет codecvt_utf8<wchar_t> codecvt_utf16<wchar_t>
wide
(wchar_t)
codecvt<wchar_t, char, mbstate_t>
mbsrtowcs / wcsrtombs
Нет Нет
новообращенные между кодировками, в том числе UTF-8, UTF-16, UTF-32
Оригинал:
converts between character encodings, including UTF-8, UTF-16, UTF-32
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(шаблон класса) [edit]
тегами, чтобы изменить поведение стандартных аспектов codecvt
Оригинал:
tags to alter behavior of the standard codecvt facets
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(класс) [edit]
преобразования между UTF-8 и UCS2/UCS4
Оригинал:
converts between UTF-8 and UCS2/UCS4
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(шаблон класса) [edit]
преобразования между UTF-16 и UCS2/UCS4
Оригинал:
converts between UTF-16 and UCS2/UCS4
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(шаблон класса) [edit]