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

The Linux Programming Interface

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

NAME         top

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

SYNOPSIS         top

       #include <wchar.h>

       int wctob(wint_t c);

DESCRIPTION         top

       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         top

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

CONFORMING TO         top

       C99.

NOTES         top

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

SEE ALSO         top

       btowc(3), wctomb(3)

COLOPHON         top

       This page is part of release 3.32 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                             WCTOB(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface