std::wstring_convert
Определено в заголовке <locale> | ||
|---|---|---|
template<
class Codecvt,
class Elem = wchar_t,
class Wide_alloc = std::allocator<Elem>,
class Byte_alloc = std::allocator<char>
> class wstring_convert;
| (с C++11) (устарело в C++17) |
Шаблон класса std::wstring_convert выполняет преобразования между строкой байтов std::string и широкой строкой std::basic_string<Elem>, используя отдельный код преобразования Codecvt. std::wstring_convert принимает на себя ответственность за код преобразования и не может использовать код преобразования, управляемый локалью. Стандартные коды преобразования, пригодные для использования с std::wstring_convert — это std::codecvt_utf8 для преобразований UTF-8/UCS-2 и UTF-8/UCS-4 и std::codecvt_utf8_utf16 для преобразований UTF-8/UTF-16.
Типы членов
| Тип члена | Определение |
|---|---|
byte_string | std::basic_string<char, char_traits<char>, Byte_alloc> |
wide_string | std::basic_string<Elem, char_traits<Elem>, Wide_alloc> |
state_type | Codecvt::state_type |
int_type | wide_string::traits_type::int_type |
Члены-функции
создаёт новый wstring_convert (публичная функция-член) |
|
| operator= | оператор копирования присваивания удалён (публичная функция-член) |
уничтожает wstring_convert и его код преобразования (публичная функция-член) |
|
| преобразует строку байтов в широкую строку (публичная функция-член) |
|
| преобразует широкую строку в строку байтов (публичная функция-член) |
|
| возвращает количество успешно преобразованных символов (публичная функция-член) |
|
| возвращает текущее состояние преобразования (публичная функция-член) |
См. также
| Преобразования символов | локально-определённые многобайтовые (UTF-8, GB18030) | UTF-8 | UTF-16 |
|---|---|---|---|
| UTF-16 |
mbrtoc16 / c16rtomb (с DR488 C11) |
| Нет данных |
| UCS-2 |
c16rtomb (без DR488 C11) |
codecvt_utf8<char16_t> |
codecvt_utf16<char16_t> |
| UTF-32 |
|
|
|
| системный wchar_t: UTF-32 (не Windows) |
|
codecvt_utf8<wchar_t> |
codecvt_utf16<wchar_t> |
|
(C++11)(устарело в C++17) | выполняет преобразование между буфером потока байтов и буфером широкого потока (шаблон класса) |
|
(C++11)(устарело в C++17)(удалено в C++26) | преобразует между UTF-8 и UCS-2/UCS-4 (шаблон класса) |
|
(C++11)(устарело в C++17)(удалено в C++26) | преобразует между UTF-8 и UTF-16 (шаблон класса) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/locale/wstring_convert
