Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

btowc(3c) [opensolaris man page]

btowc(3C)						   Standard C Library Functions 						 btowc(3C)

NAME
btowc - single-byte to wide-character conversion SYNOPSIS
#include <stdio.h> #include <wchar.h> wint_t btowc(int c); DESCRIPTION
The 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 VALUES
The 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. ERRORS
No errors are defined. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe with exceptions | +-----------------------------+-----------------------------+ SEE ALSO
setlocale(3C), wctob(3C), attributes(5), environ(5), standards(5) NOTES
The 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)

Check Out this Related Man Page

btowc(3C)						   Standard C Library Functions 						 btowc(3C)

NAME
btowc - single-byte to wide-character conversion SYNOPSIS
#include <stdio.h> #include <wchar.h> wint_t btowc(int c); DESCRIPTION
The 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 VALUES
The 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. ERRORS
No errors are defined. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe with exceptions | +-----------------------------+-----------------------------+ SEE ALSO
setlocale(3C), wctob(3C), attributes(5), environ(5), standards(5) NOTES
The btowc() function can be used safely in multithreaded applications, as long as setlocale(3C) is not being called to change the locale. SunOS 5.10 24 Jul 2002 btowc(3C)
Man Page