man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

wctob(3C)

Name

wctob - wide-character to single-byte conversion

Synopsis

#include <stdio.h>
#include <wchar.h>

int wctob(wint_t c);

Description

The wctob() function determines whether c corresponds to a member of the extended character set whose character representation is a single byte when in the initial shift state.

The behavior of this function is affected by the LC_CTYPE category of the current locale. See environ(5)

Return Values

The wctob() function returns EOF if c does not correspond to a character with length one in the initial shift state. Otherwise, it returns the single-byte representation of that character.

Errors

No errors are defined.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe with exceptions
Standard

See also

btowc(3C), setlocale(3C), attributes(5), environ(5), standards(5)

Notes

The wctob() function can be used safely in multithreaded applications, as long as setlocale(3C) is not being called to change the locale.