Standard C Library Functions                            btowc(3C)



NAME
     btowc - single-byte to wide-character conversion

SYNOPSIS
     #include 
     #include 

     wintt 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  LCTYPE
     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.

ERORS
     No errors are defined.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe with exceptions     
    


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