GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


man:btowc

BTOWC(3) Linux Programmer's Manual 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 sin-
     gle 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 mbr-
     towc(3) instead.

SEE ALSO

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

COLOPHON

     This  page  is  part of release 4.16 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/.

GNU 2015-08-08 BTOWC(3)

/data/webs/external/dokuwiki/data/pages/man/btowc.txt · Last modified: 2019/05/17 09:47 by 127.0.0.1

Was this page helpful?-11+1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki