WCTOB
Section: Linux Programmer's Manual (3)
Updated: 2021-03-22
Index
Return to Main Contents
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.11 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/.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ATTRIBUTES
-
- CONFORMING TO
-
- NOTES
-
- SEE ALSO
-
- COLOPHON
-
This document was created by
man2html,
using the manual pages.
Time: 06:22:46 GMT, May 09, 2021