btowc(3) Library Functions Manual btowc(3)
NAME
btowc - Converts a single byte from multibyte-character to wide-character format
LIBRARY
Standard C Library (libc)
SYNOPSIS
#include <stdio.h> #include <wchar.h>
wint_t btowc(
int c );
STANDARDS
Interfaces documented on this reference page conform to industry standards 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
conversion correctly sized for the %c conversion specifier that is permitted 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.
RELATED INFORMATION
Functions: mblen(3), mbtowc(3), wctob(3), wctomb(3), mbstowcs(3), wcstombs(3)
Files: locale(4) delim off
btowc(3)
