##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::wstring_convert

From cppreference.com
< cpp‎ | locale

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

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.

### [edit] 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`

### [edit] Member functions

(constructor) | constructs a new wstring_convert (public member function) [edit]
operator= | the copy assignment operator is deleted (public member function)
(destructor) | destructs the wstring_convert and its conversion facet (public member function) [edit]
from_bytes | converts a byte string into a wide string (public member function) [edit]
to_bytes | converts a wide string into a byte string (public member function) [edit]
converted | returns the number of characters successfully converted (public member function) [edit]
state | returns the current conversion state (public member function) [edit]

### [edit] See also

Character conversions | narrow multibyte (char) | UTF-8 (char) | UTF-16 (char16_t)
--- | --- | --- | ---
UTF-16 | `mbrtoc16` / `c16rtomb` | `codecvt`<char16_t, char, mbstate_t> `codecvt_utf8_utf16`<char16_t> `codecvt_utf8_utf16`<char32_t> `codecvt_utf8_utf16`<wchar_t> | N/A
UCS2 | No | `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

wbuffer_convert (C++11) | performs conversion between a byte stream buffer and a wide stream buffer (class template) [edit]
codecvt_utf8 (C++11) | converts between UTF-8 and UCS2/UCS4 (class template) [edit]
codecvt_utf8_utf16 (C++11) | converts between UTF-8 and UTF-16 (class template) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/locale/wstring_convert&oldid=62762"