wctob(3)

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