Difference between revisions of "cpp/locale/wstring convert"
m (Shorten template names. Use {{lc}} where appropriate.) |
m (Update links.) |
||
| Line 25: | Line 25: | ||
===Member functions=== | ===Member functions=== | ||
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc inc | cpp/locale/wstring_convert/ | + | {{dsc inc | cpp/locale/wstring_convert/dsc wstring_convert}} |
{{dsc mem fun | nolink=true | operator{{=}} | the copy assignment operator is deleted }} | {{dsc mem fun | nolink=true | operator{{=}} | the copy assignment operator is deleted }} | ||
| − | {{dsc inc | cpp/locale/wstring_convert/ | + | {{dsc inc | cpp/locale/wstring_convert/dsc ~wstring_convert}} |
| − | {{dsc inc | cpp/locale/wstring_convert/ | + | {{dsc inc | cpp/locale/wstring_convert/dsc from_bytes}} |
| − | {{dsc inc | cpp/locale/wstring_convert/ | + | {{dsc inc | cpp/locale/wstring_convert/dsc to_bytes}} |
| − | {{dsc inc | cpp/locale/wstring_convert/ | + | {{dsc inc | cpp/locale/wstring_convert/dsc converted}} |
| − | {{dsc inc | cpp/locale/wstring_convert/ | + | {{dsc inc | cpp/locale/wstring_convert/dsc state}} |
{{dsc end}} | {{dsc end}} | ||
| Line 37: | Line 37: | ||
{{cpp/locale/unicode string conversions}} | {{cpp/locale/unicode string conversions}} | ||
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc inc | cpp/locale/ | + | {{dsc inc | cpp/locale/dsc wbuffer_convert}} |
| − | {{dsc inc | cpp/locale/ | + | {{dsc inc | cpp/locale/dsc codecvt_utf8}} |
| − | {{dsc inc | cpp/locale/ | + | {{dsc inc | cpp/locale/dsc codecvt_utf8_utf16}} |
{{dsc end}} | {{dsc end}} | ||
Revision as of 22:11, 31 May 2013
| Defined in header <locale>
|
||
| template< class Codecvt, class Elem = wchar_t, |
(since C++11) | |
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/UCS2 and UTF-8/UCS4 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) |
