*** UNIX MANUAL PAGE BROWSER ***

btowc(3) Library Functions Manual btowc(3) NAME btowc - Converts a single byte from multibyte-character to wide-charac- ter format LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <stdlib.h> #include <wchar.h> wint_t btowc( wint_t c ); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: btowc(): ISO C Refer to the standards(5) reference page for more information about in- dustry 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 The btowc() function sets errno to the values specified for the follow- ing conditions: An invalid character value was encountered. RELATED INFORMATION Functions: mblen(3), mbtowc(3), wctob(3), wctomb(3), mbstowcs(3), wc- stombs(3) Files: locale(4) delim off btowc(3)