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)
Generated by dwww version 1.16 on Tue Dec 16 04:25:53 CET 2025.