bionic (3) wctob.3.gz

Provided by: manpages-dev_4.15-1_all bug

NAME
       wctob - try to represent a wide character as a single byte


SYNOPSIS
       #include <wchar.h>

       int wctob(wint_t c);


DESCRIPTION
       The  wctob() function tests whether the multibyte representation of the wide character c, starting in the
       initial state, consists of a single byte.  If so, it is returned as an unsigned char.

       Never use this function.  It cannot help you in writing  internationalized  programs.   Internationalized
       programs must never distinguish single-byte and multibyte characters.


RETURN VALUE
       The wctob() function returns the single-byte representation of c, if it exists, of EOF otherwise.


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

       ┌──────────┬───────────────┬─────────┐
       │Interface │ Attribute     │ Value   │
       ├──────────┼───────────────┼─────────┤
       │wctob()   │ Thread safety │ MT-Safe │
       └──────────┴───────────────┴─────────┘


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


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

       This  function  should  never be used.  Internationalized programs must never distinguish single-byte and
       multibyte characters.  Use either wctomb(3) or the thread-safe wcrtomb(3) instead.


SEE ALSO
       btowc(3), wcrtomb(3), wctomb(3)


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