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 at-
tributes(7).
┌────────────────────────────────────────────┬───────────────┬─────────┐
│Interface │ Attribute │ Value │
├────────────────────────────────────────────┼───────────────┼─────────┤
│wctob() │ Thread safety │ MT-Safe │
└────────────────────────────────────────────┴───────────────┴─────────┘
STANDARDS
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 wc-
tomb(3) or the thread-safe wcrtomb(3) instead.
SEE ALSO
btowc(3), wcrtomb(3), wctomb(3)
Linux man-pages 6.03 2022-12-15 wctob(3)
Generated by dwww version 1.15 on Sat Jun 29 23:19:34 CEST 2024.