search..
No manual entry for -- in section 3
wctob(3)		    Library Functions Manual		       wctob(3)

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

LIBRARY
       Standard C library (libc, -lc)

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 international-
       ized programs.  Internationalized programs must never  distinguish  sin-
       gle-byte and multibyte characters.

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

ATTRIBUTES
       For an explanation of the terms used in this section, see attributes(7).
       +--------------------------------------------+---------------+---------+
       | Interface				    | Attribute	    | Value   |
       +--------------------------------------------+---------------+---------+
       | wctob()				    | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+

STANDARDS
       C11, POSIX.1-2008.

HISTORY
       POSIX.1-2001, 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  wc-
       tomb(3) or the thread-safe wcrtomb(3) instead.

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

Linux man-pages 6.9.1		   2024-05-02			       wctob(3)