WCTOB
Section: Linux Programmer's Manual (3)
Updated: 2017-09-15
Page Index
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, 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
|
CONFORMING TO
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 5.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/.