Manual Pages for UNIX Operating System command usage for man btowc

Standard C Library Functions                            btowc(3C)



NAME
     btowc - single-byte to wide-character conversion

SYNOPSIS
     #include 
     #include 

     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       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     setlocale(3C), wctob(3C), attributes(5),  environ(5),  stan-
     dards(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          Last change: 24 Jul 2002                    1