std::wbuffer_convert

 

C++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Execution support library (C++26)

Technical specifications

Symbols index

External libraries

 

Localization library

Locales and facets
Locales
has_facet use_facet	locale
Facet category base classes
ctype_base codecvt_base messages_base	time_base money_base
ctype facets
ctype ctype<char> ctype_byname	codecvt codecvt_byname
numeric facets
num_get num_put	numpunct numpunct_byname
collate facets
collate	collate_byname
time facets
time_get time_put	time_get_byname time_put_byname
monetary facets
money_get money_put	moneypunct moneypunct_byname
messages facets
messages	messages_byname

Character classification and conversion
Character classification
isspace isblank (C++11) iscntrl	isupper islower isalpha	ispunct isdigit isxdigit	isalnum isprint isgraph

Character conversions

toupper

tolower

String and stream conversions

wstring_convert (C++11/17/26*)

wbuffer_convert (C++11/17/26*)

Text encoding identifications

text_encoding (C++26)

Unicode conversion facets

codecvt_utf8 (C++11/17/26*)

codecvt_utf16 (C++11/17/26*)

codecvt_utf8_utf16 (C++11/17/26*)

codecvt_mode (C++11/17/26*)

C library locales
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

std::wbuffer_convert

Member functions

wbuffer_convert::wbuffer_convert

wbuffer_convert::~wbuffer_convert

wbuffer_convert::rdbuf

wbuffer_convert::state

 

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) (deprecated in C++17) (removed in C++26)

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

Type	Definition
state_type	Codecvt::state_type

Data members

Member	Description
std::streambuf* bufptr	a pointer to the underlying byte stream buffer (exposition-only member object*)
Codecvt* cvtptr	a pointer to the allocated conversion object (exposition-only member object*)
state_type cvtstate	the conversion state object (exposition-only member object*)

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 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> codecvt_utf8_utf16<char16_t> codecvt_utf8_utf16<char32_t> codecvt_utf8_utf16<wchar_t>	N/A
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_utf8<char32_t>	codecvt_utf16<char32_t>
system wchar_t: UTF-32 (non-Windows) UCS-2 (Windows)	mbsrtowcs / wcsrtombs use_facet<codecvt <wchar_t,char,mbstate_t>>(locale)	codecvt_utf8<wchar_t>	codecvt_utf16<wchar_t>

wstring_convert (C++11)(deprecated in C++17)(removed in C++26)	performs conversions between a wide string and a byte string (class template)
codecvt_utf8 (C++11)(deprecated in C++17)(removed in C++26)	converts between UTF-8 and UCS-2/UCS-4 (class template)
codecvt_utf8_utf16 (C++11)(deprecated in C++17)(removed in C++26)	converts between UTF-8 and UTF-16 (class template)