std::wstring_convert (3) - Linux Manuals

std::wstring_convert: std::wstring_convert

NAME

std::wstring_convert - std::wstring_convert

Synopsis

Defined in header <locale>
template< class Codecvt,
class Elem = wchar_t, (since C++11)
class Wide_alloc = std::allocator<Elem>, (deprecated in C++17)
class Byte_alloc = std::allocator<char> >
class wstring_convert;

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
constructor (public member function)
              the copy assignment operator is deleted
operator= (public member function)
              destructs the wstring_convert and its conversion facet
destructor (public member function)
              converts a byte string into a wide string
from_bytes (public member function)
              converts a wide string into a byte string
to_bytes (public member function)
              returns the number of characters successfully converted
converted (public member function)
              returns the current conversion state
state (public member function)