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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|

SEE ALSO

     setlocale(3C), wctob(3C), attributes(5), environ(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.