HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

100

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

btowc(3C) btowc(3C)

NAME

btowc(), wctob() - conversion between single-byte and wide-character

SYNOPSIS

#include <stdio.h>

#include <wchar.h>

wint_t btowc(int c);

int wctob(wint_t c);

DESCRIPTION

btowc() The btowc() function determines whether c constitutes a valid (one-byte) character in

the initial shift state.

wctob() 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.

APPLICATION USAGE

btowc() and wctob() are thread-safe.

EXTERNAL INFLUENCES

locale

The behavior of these functions is affected by the LC_CTYPE category.

RETURN VALUE

The btowc() function returns WEOF if c has the value EOF or if c as an unsigned character does not con-

stitute a valid (one-byte) character in the initial shift state. Otherwise, it returns the wide-character

representation of that character.

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 deﬁned.

AUTHOR

btowc() was developed by HP and MitsubishiElectric Corp.