.TH "std::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >" 3cxx "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME std::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc > \- String conversions\&. .SH SYNOPSIS .br .PP .PP \fC#include \fP .SS "Public Types" .in +1c .ti -1c .RI "\fBtypedef\fP \fBbasic_string\fP< char, \fBchar_traits\fP< char >, \fB_Byte_alloc\fP > \fBbyte_string\fP" .br .ti -1c .RI "\fBtypedef\fP wide_string::traits_type::int_type \fBint_type\fP" .br .ti -1c .RI "\fBtypedef\fP _Codecvt::state_type \fBstate_type\fP" .br .ti -1c .RI "\fBtypedef\fP \fBbasic_string\fP< \fB_Elem\fP, \fBchar_traits\fP< \fB_Elem\fP >, \fB_Wide_alloc\fP > \fBwide_string\fP" .br .in -1c .SS "Public Member Functions" .in +1c .ti -1c .RI "\fBwstring_convert\fP ()" .br .RI "Default constructor\&. " .ti -1c .RI "\fBwstring_convert\fP (\fB_Codecvt\fP *\fB__pcvt\fP)" .br .ti -1c .RI "\fBwstring_convert\fP (\fB_Codecvt\fP *\fB__pcvt\fP, state_type \fB__state\fP)" .br .ti -1c .RI "\fBwstring_convert\fP (\fBconst\fP \fBbyte_string\fP &\fB__byte_err\fP, \fBconst\fP \fBwide_string\fP &\fB__wide_err\fP=\fBwide_string\fP())" .br .ti -1c .RI "\fBwstring_convert\fP (\fBconst\fP \fBwstring_convert\fP &)=\fBdelete\fP" .br .ti -1c .RI "size_t \fBconverted\fP () \fBconst\fP \fBnoexcept\fP" .br .RI "The number of elements successfully converted in the last conversion\&. " .ti -1c .RI "\fBwstring_convert\fP & \fBoperator=\fP (\fBconst\fP \fBwstring_convert\fP &)=\fBdelete\fP" .br .ti -1c .RI "state_type \fBstate\fP () \fBconst\fP" .br .RI "The final conversion state of the last conversion\&. " .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBwide_string\fP \fBfrom_bytes\fP (char \fB__byte\fP)" .br .RI "Convert from bytes\&. " .ti -1c .RI "\fBwide_string\fP \fBfrom_bytes\fP (\fBconst\fP char *\fB__ptr\fP)" .br .RI "Convert from bytes\&. " .ti -1c .RI "\fBwide_string\fP \fBfrom_bytes\fP (\fBconst\fP \fBbyte_string\fP &\fB__str\fP)" .br .RI "Convert from bytes\&. " .ti -1c .RI "\fBwide_string\fP \fBfrom_bytes\fP (\fBconst\fP char *__first, \fBconst\fP char *__last)" .br .RI "Convert from bytes\&. " .in -1c .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBbyte_string\fP \fBto_bytes\fP (\fB_Elem\fP \fB__wchar\fP)" .br .RI "Convert to bytes\&. " .ti -1c .RI "\fBbyte_string\fP \fBto_bytes\fP (\fBconst\fP \fB_Elem\fP *\fB__ptr\fP)" .br .RI "Convert to bytes\&. " .ti -1c .RI "\fBbyte_string\fP \fBto_bytes\fP (\fBconst\fP \fBwide_string\fP &\fB__wstr\fP)" .br .RI "Convert to bytes\&. " .ti -1c .RI "\fBbyte_string\fP \fBto_bytes\fP (\fBconst\fP \fB_Elem\fP *__first, \fBconst\fP \fB_Elem\fP *__last)" .br .RI "Convert to bytes\&. " .in -1c .in -1c .SH "Detailed Description" .PP .SS "template<\fBtypename\fP \fB_Codecvt\fP, \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> .br class std::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >"String conversions\&. .SH "Constructor & Destructor Documentation" .PP .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::wstring_convert ()\fC [inline]\fP" .PP Default constructor\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::wstring_convert (\fB_Codecvt\fP * __pcvt)\fC [inline]\fP, \fC [explicit]\fP" Constructor\&. .PP \fBParameters\fP .RS 4 \fI__pcvt\fP The facet to use for conversions\&. .RE .PP Takes ownership of \fC__pcvt\fP and will delete it in the destructor\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::wstring_convert (\fB_Codecvt\fP * __pcvt, state_type __state)\fC [inline]\fP" Construct with an initial converstion state\&. .PP \fBParameters\fP .RS 4 \fI__pcvt\fP The facet to use for conversions\&. .br \fI__state\fP Initial conversion state\&. .RE .PP Takes ownership of \fC__pcvt\fP and will delete it in the destructor\&. The object's conversion state will persist between conversions\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::wstring_convert (\fBconst\fP \fBbyte_string\fP & __byte_err, \fBconst\fP \fBwide_string\fP & __wide_err = \fC\fBwide_string\fP()\fP)\fC [inline]\fP, \fC [explicit]\fP" Construct with error strings\&. .PP \fBParameters\fP .RS 4 \fI__byte_err\fP A string to return on failed conversions\&. .br \fI__wide_err\fP A wide string to return on failed conversions\&. .RE .PP .SH "Member Function Documentation" .PP .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> size_t \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::converted () const\fC [inline]\fP, \fC [noexcept]\fP" .PP The number of elements successfully converted in the last conversion\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBwide_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::from_bytes (char __byte)\fC [inline]\fP" .PP Convert from bytes\&. .PP References \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::from_bytes()\fP\&. .PP Referenced by \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::from_bytes()\fP, \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::from_bytes()\fP, and \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::from_bytes()\fP\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBwide_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::from_bytes (\fBconst\fP \fBbyte_string\fP & __str)\fC [inline]\fP" .PP Convert from bytes\&. .PP References \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::from_bytes()\fP\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBwide_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::from_bytes (\fBconst\fP char * __first, \fBconst\fP char * __last)\fC [inline]\fP" .PP Convert from bytes\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBwide_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::from_bytes (\fBconst\fP char * __ptr)\fC [inline]\fP" .PP Convert from bytes\&. .PP References \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::from_bytes()\fP\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> state_type \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::state () const\fC [inline]\fP" .PP The final conversion state of the last conversion\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBbyte_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::to_bytes (\fB_Elem\fP __wchar)\fC [inline]\fP" .PP Convert to bytes\&. .PP References \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::to_bytes()\fP\&. .PP Referenced by \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::to_bytes()\fP, \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::to_bytes()\fP, and \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::to_bytes()\fP\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBbyte_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::to_bytes (\fBconst\fP \fB_Elem\fP * __first, \fBconst\fP \fB_Elem\fP * __last)\fC [inline]\fP" .PP Convert to bytes\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBbyte_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::to_bytes (\fBconst\fP \fB_Elem\fP * __ptr)\fC [inline]\fP" .PP Convert to bytes\&. .PP References \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::to_bytes()\fP\&. .SS "template<\fBtypename\fP \fB_Codecvt\fP , \fBtypename\fP \fB_Elem\fP = wchar_t, \fBtypename\fP \fB_Wide_alloc\fP = allocator<_Elem>, \fBtypename\fP \fB_Byte_alloc\fP = allocator> \fBbyte_string\fP \fBstd::wstring_convert\fP< \fB_Codecvt\fP, \fB_Elem\fP, \fB_Wide_alloc\fP, \fB_Byte_alloc\fP >::to_bytes (\fBconst\fP \fBwide_string\fP & __wstr)\fC [inline]\fP" .PP Convert to bytes\&. .PP References \fBstd::wstring_convert< _Codecvt, _Elem, _Wide_alloc, _Byte_alloc >::to_bytes()\fP\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.