NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | CONFORMING TO | NOTES | SEE ALSO | COLOPHON

BTOWC(3)                      Linux Programmer's Manual                      BTOWC(3)

NAME         top

       btowc - convert single byte to wide character

SYNOPSIS         top

       #include <wchar.h>

       wint_t btowc(int c);

DESCRIPTION         top

       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         top

       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.

CONFORMING TO         top

       C99, POSIX.1-2001.

NOTES         top

       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 the function mbtowc() instead.

SEE ALSO         top

       wctob(3), mbtowc(3)

COLOPHON         top

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

GNU                                   2009-02-04                             BTOWC(3)