Scroll to navigation

WCTOB(3) Linux Programmer's Manual WCTOB(3)

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

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

2017-09-15 GNU