std::wstring_convert
Defined in header <locale>
|
||
|
template
<
class Codecvt, |
(since C++11) (deprecated in C++17) (removed in C++26) |
|
Class template std::wstring_convert performs conversions between byte string std::string and wide string
std::basic_string
<Elem>
, using an individual code conversion facet Codecvt. std::wstring_convert
The standard facets suitable for use with std::wstring_convert are std::codecvt_utf8 for UTF-8/UCS-2 and UTF-8/UCS-4 conversions and std::codecvt_utf8_utf16
Nested types
| 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 |
Data members
| 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_t cvtcount
|
the conversion count (exposition-only member object* |
Member functions
constructs a new wstring_convert (public member function) |
|
operator= |
the copy assignment operator is deleted (public member function) |
destructs the wstring_convert and its conversion facet (public member function) |
|
| converts a byte string into a wide string (public member function) |
|
| converts a wide string into a byte string (public member function) |
|
| returns the number of characters successfully converted (public member function) |
|
| returns the current conversion state (public member function) |
See also
| 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> |
|
| system wchar_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) |
|
(C++11)
(deprecated in C++17)
(removed in C++26)
|
converts between UTF-8 and UCS-2/UCS-4 (class template) |
|
(C++11)
(deprecated in C++17)
(removed in C++26)
|
converts between UTF-8 and UTF-16 (class template) |