Query: btowc
OS: opensolaris
Section: 3c
Links: opensolaris man pages all man pages forum categories
Format:Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
btowc(3C) Standard C Library Functions btowc(3C)NAMEbtowc - single-byte to wide-character conversionSYNOPSIS#include <stdio.h> #include <wchar.h> wint_t btowc(int c);DESCRIPTIONThe btowc() function determines whether c constitutes a valid (one-byte) character in the initial shift state. The behavior of this function is affected by the LC_CTYPE category of the current locale. See environ(5).RETURN VALUESThe btowc() function returns WEOF if c has the value EOF or if (unsigned char)c does not constitute a valid (one-byte) character in the initial shift state. Otherwise, it returns the wide-character representation of that character.ERRORSNo errors are defined.ATTRIBUTESSee attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe with exceptions | +-----------------------------+-----------------------------+SEE ALSOsetlocale(3C), wctob(3C), attributes(5), environ(5), standards(5)NOTESThe btowc() function can be used safely in multithreaded applications, as long as setlocale(3C) is not being called to change the locale. SunOS 5.11 24 Jul 2002 btowc(3C)