std::wbuffer_convert

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 types

Member type Definition
state_type Codecvt::state_type

Member functions

constructs a new wbuffer_convert
(public member function)
operator=
the copy assignment operator is deleted
(public member function)
(destructor)
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)

See also

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
performs conversions between a wide string and a byte string
(class template)
(C++11)
converts between UTF-8 and UCS2/UCS4
(class template)
converts between UTF-8 and UTF-16
(class template)
doc_CPP
2016-10-11 10:08:25
Comments
Leave a Comment

Please login to continue.