std::wbuffer_convert(3)

NAME
std::wbuffer_convert - std::wbuffer_convert

Synopsis
   Defined in header <locale>
   template<
       class Codecvt, (since C++11)
       class Elem = wchar_t, (deprecated in C++17)
       class Tr = std::char_traits<Elem> (removed in C++26)
   > class wbuffer_convert : public std::basic_streambuf<Elem,
   Tr>
   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/UCS-2 and UTF-8/UCS-4 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
   constructor 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)
   rdbuf returns or replaces the underlying narrow stream buffer
                 (public member function)
   state returns the current conversion state
                 (public member function)

See also
  Character locale-defined multibyte UTF-8 UTF-16
 conversions (UTF-8, GB18030)
                        codecvt<char16_t,char,mbstate_t>
   UTF-16 mbrtoc16 / c16rtomb (with C11's codecvt_utf8_utf16<char16_t> N/A
              DR488) codecvt_utf8_utf16<char32_t>
                        codecvt_utf8_utf16<wchar_t>
    UCS-2 c16rtomb (without C11's DR488) codecvt_utf8<char16_t> codecvt_utf16<char16_t>
   UTF-32 mbrtoc32 / c32rtomb codecvt<char32_t,char,mbstate_t> codecvt_utf16<char32_t>
                        codecvt_utf8<char32_t>
   system
  wchar_t:
              mbsrtowcs / wcsrtombs
   UTF-32 use_facet<codecvt codecvt_utf8<wchar_t> codecvt_utf16<wchar_t> (non-Windows) <wchar_t,char,mbstate_t>>(locale)
    UCS-2
  (Windows)
   wstring_convert
   (C++11) performs conversions between a wide string and a byte string
   (deprecated in C++17) (class template)
   (removed in C++26)
   codecvt_utf8
   (C++11) converts between UTF-8 and UCS-2/UCS-4
   (deprecated in C++17) (class template)
   (removed in C++26)
   codecvt_utf8_utf16
   (C++11) converts between UTF-8 and UTF-16
   (deprecated in C++17) (class template)
   (removed in C++26)