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