public member function
<ios> <iostream>

std::basic_ios::widen

char_type widen (char c) const;
Widen character
Returns the transformation of the narrow character c to its equivalent of type char_type (generally, a wide character type).

This function returns the result of calling the ctype::widen facet of the locale object currently imbued in the stream.

Parameters

c
Narrow character to be widened.

Return Value

The char_type equivalent of c.
Member type char_type is the type of characters used by the stream (i.e., its first class template parameter, charT).

Data races

Accesses the stream object.
Concurrent access to the same stream object may cause data races.

Exception safety

Strong guarantee: if an exception is thrown, there are no changes in the stream.

See also