Scroll to navigation

wctob(3) Library Functions Manual wctob(3)

NAME

wctob - try to represent a wide character as a single byte

LIBRARY

Standard C library (libc, -lc)

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

STANDARDS

C11, POSIX.1-2008.

HISTORY

POSIX.1-2001, 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)

2024-05-02 Linux man-pages (unreleased)