| Defined in header
<locale> | ||
|---|---|---|
template<class Codecvt,
class Elem = wchar_t,
class Tr = std::char_traits<Elem> >
class wbuffer_convert : public std::basic_streambuf<Elem, Tr>
| (since C++11) |
std::wbuffer_convert is a wrapper over stream buffer of type std::basic_streambuf<char> which gives it the appearance of std::basic_streambuf<Elem>. All I/O performed through std::wbuffer_convert undergoes character conversion as defined by the facet Codecvt. std::wbuffer_convert assumes ownership of the conversion facet, and cannot use a facet managed by a locale. The standard facets suitable for use with std::wbuffer_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.
This class template makes the implicit character conversion functionality of std::basic_filebuf available for any std::basic_streambuf.
| Member type | Definition |
|---|---|
state_type | Codecvt::state_type |
| constructs a new wbuffer_convert (public member function) |
|
| operator= | the copy assignment operator is deleted (public member function) |
| destructs the wbuffer_convert and its conversion facet (public member function) |
|
| returns or replaces the underlying narrow stream buffer (public member function) |
|
| returns the current conversion state (public member function) |
| Character conversions | narrow multibyte (char) | UTF-8 (char) | UTF-16 (char16_t) |
|---|---|---|---|
| UTF-16 |
mbrtoc16(one way) |
codecvt<char16_t, char, mbstate_t>codecvt_utf8_utf16<char16_t>codecvt_utf8_utf16<char32_t>codecvt_utf8_utf16<wchar_t> | N/A |
| UCS2 |
c16rtomb(one way) |
codecvt_utf8<char16_t> |
codecvt_utf16<char16_t> |
| UTF-32/UCS4 (char32_t) |
mbrtoc32 / c32rtomb |
codecvt<char32_t, char, mbstate_t>codecvt_utf8<char32_t> |
codecvt_utf16<char32_t> |
| UCS2/UCS4 (wchar_t) | No |
codecvt_utf8<wchar_t> |
codecvt_utf16<wchar_t> |
| wide (wchar_t) |
codecvt<wchar_t, char, mbstate_t>mbsrtowcs / wcsrtombs | No | No |
| (C++11)
| performs conversions between a wide string and a byte string (class template) |
| (C++11)
| converts between UTF-8 and UCS2/UCS4 (class template) |
| (C++11)
| converts between UTF-8 and UTF-16 (class template) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/locale/wbuffer_convert