btowc(3)btowc(3)NAMEbtowc - Convert a single byte from multibyte-character to wide-charac‐
ter format
SYNOPSIS
#include <stdio.h> #include <wchar.h>
wint_t btowc(
int c );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
btowc(): ISO C, XSH5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Points to a variable containing a single-byte character.
DESCRIPTION
The btowc() function determines if a single-byte value constitutes a
valid character in the initial shift state from a multibyte codeset. If
so, the function returns the corresponding wide-character value. This
function provides a multibyte-character to wide-character format con‐
version correctly sized for the %c conversion specifier that is permit‐
ted in calls to *printf() functions. In general, use either the
mbtowc() or mbrtowc() function to perform multibyte-character to wide-
character format conversions of single characters.
RETURN VALUES
The btowc() function returns one of the following: The counterpart
wide-character value, if c contains a valid multibyte character in the
initial shift state WEOF, if c contains EOF or does not constitute a
valid character in the initial shift state from a multibyte codeset
ERRORS
No errors are defined.
SEE ALSO
Functions: mblen(3), mbtowc(3), wctob(3), wctomb(3), mbstowcs(3),
wcstombs(3)
Files: locale(4)btowc(3)