*** UNIX MANUAL PAGE BROWSER ***

wctob(3) Library Functions Manual wctob(3) NAME wctob - Converts a wide character to a single byte in multibyte-charac- ter format LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <stdlib.h> #include <wchar.h> int wctob( wint_t wc ); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: wctob(): 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 wide-character value. DESCRIPTION The wctob() function determines if a wide-character value constitutes a valid single-byte character in the initial shift state from a multibyte codeset. If so, the function returns the corresponding multibyte char- acter. This function provides a wide-character to multibyte-character format conversion correctly sized for the %c conversion specifier that is permitted in calls to *printf() functions. In general, use either the wctomb() or wcrtomb() function to perform wide-character to multi- byte-character format conversions of single characters. RETURN VALUES The wctob() function returns one of the following: The counterpart multibyte-character value, if wc can be converted to a multibyte char- acter that is 1 byte in length and in the initial shift state EOF, if wc does not correspond to a valid multibyte character that is 1 byte in length and in the initial shift state ERRORS The wctob() function sets errno to the specified value for the follow- ing conditions: An invalid character value is encountered. RELATED INFORMATION Functions: btowc(3), mblen(3), mbtowc(3), wctomb(3), mbstowcs(3), wc- stombs(3) Files: locale(4) delim off wctob(3)