wctob(3)wctob(3)NAMEwctob - Convert a wide character to a single byte in multibyte-charac‐
ter format
SYNOPSIS
#include <stdlib.h> #include <wchar.h>
int wctob(
wint_t wc );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
wctob(): XSH5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Points to a variable containing a wide-character value.
DESCRIPTION
The wctob() function determines if a wide-character value constitutes a
valid single-byte character in the initial shift state from a multibyte
codeset. If so, the function returns the corresponding multibyte char‐
acter. This function provides a wide-character to multibyte-character
format conversion correctly sized for the %c conversion specifier that
is permitted in calls to *printf() functions.
In general, use either the wctomb() or wcrtomb() function to perform
wide-character to multibyte-character format conversions of single
characters. Converting only the characters whose encoding requires one
byte has limited usefulness in multibyte codesets, where codes for many
or most characters require multiple bytes.
RETURN VALUES
The wctob() function returns one of the following: The counterpart
multibyte-character value, if wc can be converted to a multibyte-format
character that is 1 byte in length and in the initial shift state EOF,
if wc does not correspond to a valid multibyte character that is 1 byte
in length and in the initial shift state
ERRORS
The wctob() function sets errno to the specified value for the follow‐
ing conditions: An invalid character value is encountered.
SEE ALSO
Functions: btowc(3), mblen(3), mbtowc(3), wctomb(3), mbstowcs(3),
wcstombs(3)
Files: locale(4)wctob(3)