Localization library | |||||||||||||||||||||||||
Regular expressions library(C++11) | |||||||||||||||||||||||||
Formatting library(C++20) | |||||||||||||||||||||||||
Null-terminated sequence utilities | |||||||||||||||||||||||||
Byte strings | |||||||||||||||||||||||||
Multibyte strings | |||||||||||||||||||||||||
Wide strings | |||||||||||||||||||||||||
Primitive numeric conversions | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
Text encoding identifications | |||||||||||||||||||||||||
|
|
Defined in header <locale> | ||
template< class Codecvt, | (since C++11) (deprecated in C++17) (removed in C++26) | |
Class templatestd::wstring_convert
performs conversions between byte stringstd::string and wide stringstd::basic_string<Elem>, using an individual code conversion facetCodecvt
.std::wstring_convert
assumes ownership of the conversion facet, and cannot use a facet managed by a locale.
The standard facets suitable for use withstd::wstring_convert
arestd::codecvt_utf8 for UTF-8/UCS-2 and UTF-8/UCS-4 conversions andstd::codecvt_utf8_utf16 for UTF-8/UTF-16 conversions.
Contents |
Type | Definition |
byte_string | std::basic_string<char,std::char_traits<char>, Byte_alloc> |
wide_string | std::basic_string<Elem,std::char_traits<Elem>, Wide_alloc> |
state_type | typename Codecvt::state_type |
int_type | typename wide_string::traits_type::int_type |
Member | Description |
byte_string byte_err_string | the byte string to display on errors (exposition-only member object*) |
wide_string wide_err_string | the wide string to display on errors (exposition-only member object*) |
Codecvt*cvtptr | a pointer to the allocated conversion object (exposition-only member object*) |
state_type cvtstate | the conversion state object (exposition-only member object*) |
std::size_tcvtcount | the conversion count (exposition-only member object*) |
constructs a newwstring_convert (public member function)[edit] | |
operator= | the copy assignment operator is deleted (public member function) |
destructs thewstring_convert and its conversion facet(public member function)[edit] | |
converts a byte string into a wide string (public member function)[edit] | |
converts a wide string into a byte string (public member function)[edit] | |
returns the number of characters successfully converted (public member function)[edit] | |
returns the current conversion state (public member function)[edit] |
Character conversions | locale-defined multibyte (UTF-8, GB18030) | UTF-8 | UTF-16 |
---|---|---|---|
UTF-16 | mbrtoc16 /c16rtomb(with C11's DR488) | codecvt<char16_t,char,mbstate_t> | N/A |
UCS-2 | c16rtomb(without C11's DR488) | codecvt_utf8<char16_t> | codecvt_utf16<char16_t> |
UTF-32 | codecvt<char32_t,char,mbstate_t> | codecvt_utf16<char32_t> | |
systemwchar_t: UTF-32(non-Windows) | mbsrtowcs /wcsrtombs | codecvt_utf8<wchar_t> | codecvt_utf16<wchar_t> |
(C++11)(deprecated in C++17)(removed in C++26) | performs conversion between a byte stream buffer and a wide stream buffer (class template)[edit] |
(C++11)(deprecated in C++17)(removed in C++26) | converts between UTF-8 and UCS-2/UCS-4 (class template)[edit] |
(C++11)(deprecated in C++17)(removed in C++26) | converts between UTF-8 and UTF-16 (class template)[edit] |