btowc(3)

NAME

   btowc - convert single byte to wide character

SYNOPSIS

   #include <wchar.h>

   wint_t btowc(int c);

DESCRIPTION

   The btowc() function converts c, interpreted as a multibyte sequence of
   length 1, starting in the initial shift state, to a wide character  and
   returns it.  If c is EOF or not a valid multibyte sequence of length 1,
   the btowc() function returns WEOF.

RETURN VALUE

   The btowc() function returns the  wide  character  converted  from  the
   single byte c.  If c is EOF or not a valid multibyte sequence of length
   1, it returns WEOF.

ATTRIBUTES

   For  an  explanation  of  the  terms  used   in   this   section,   see
   attributes(7).

   
   Interface  Attribute      Value   
   
   btowc()    Thread safety  MT-Safe 
   

CONFORMING TO

   POSIX.1-2001, POSIX.1-2008, C99.

NOTES

   The behavior of btowc() depends on the LC_CTYPE category of the current
   locale.

   This function should never be used.  It does  not  work  for  encodings
   which  have  state,  and  unnecessarily treats single bytes differently
   from multibyte sequences.  Use  either  mbtowc(3)  or  the  thread-safe
   mbrtowc(3) instead.

SEE ALSO

   mbrtowc(3), mbtowc(3), wctob(3)

COLOPHON

   This  page  is  part of release 4.09 of the Linux man-pages project.  A
   description of the project, information about reporting bugs,  and  the
   latest     version     of     this    page,    can    be    found    at
   https://www.kernel.org/doc/man-pages/.

---

Free and Open Source Software