wctob

Section: C Library Functions (3)
Updated: 2022-12-15
Index Return to Main Contents
 

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).
InterfaceAttributeValue
wctob() Thread safetyMT-Safe

 

STANDARDS

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)


 

Index

NAME
LIBRARY
SYNOPSIS
DESCRIPTION
RETURN VALUE
ATTRIBUTES
STANDARDS
NOTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 16:57:20 GMT, May 18, 2024