std::btowc

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

char_traits

 

Null-terminated multibyte strings

Wide/multibyte conversions
mbsinit
mbtowc mbstowcs btowc mbrtowc mbsrtowcs mbrtoc16 (C++11) mbrtoc32 (C++11) mblen	wctomb wcstombs wctob wcrtomb wcsrtombs c16rtomb (C++11) c32rtomb (C++11) mbrlen
Types
mbstate_t

 

Defined in header <cwchar>
std::wint_t btowc( int c );

Widens a single-byte character c to its wide character equivalent.

Most multibyte character encodings use single-byte codes to represent the characters from the ASCII character set. This function may be used to convert such characters to wchar_t.

Parameters

c

-

single-byte character to widen

Return value

WEOF if c is EOF.

Wide character representation of c if (unsigned char)c is a valid single-byte character in the initial shift state, WEOF otherwise.

Example

#include <cwchar>
#include <cstdio>
#include <clocale>
 
int main()
{
    std::setlocale(LC_ALL, "");
    std::wprintf(L"wide: %lc\nwidened from narrow: %lc\n", L'a', std::btowc('a'));
}

Output:

wide: a
widened from narrow: a

See also

wctob	narrows a wide character to a single-byte narrow character, if possible (function)
do_widen [virtual]	converts a character or characters from char to charT (virtual protected member function of std::ctype)
C documentation for btowc