Difference between revisions of "cpp/locale/wstring convert"
m (→Synopsis: fmt) |
YexuanXiao (Talk | contribs) m (removed=c++26) |
||
| Line 1: | Line 1: | ||
{{cpp/title|wstring_convert}} | {{cpp/title|wstring_convert}} | ||
{{cpp/locale/wstring_convert/navbar}} | {{cpp/locale/wstring_convert/navbar}} | ||
| − | {{ddcl|header=locale|since=c++11|deprecated=c++17|1= | + | {{ddcl|header=locale|since=c++11|deprecated=c++17|removed=c++26|1= |
template< | template< | ||
class Codecvt, | class Codecvt, | ||
Revision as of 00:44, 16 April 2024
| 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 assumes ownership of the conversion facet, and cannot use a facet managed by a locale. 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 for UTF-8/UTF-16 conversions.
Member types
| Member type | Definition |
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
|
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) |
