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

The prototypes of these functions are available to applications if they are:

a.: c99 conformant.
b.: Compiled with the -D_XOPEN_SOURCE macro with a value >=500.
c.: Compiled with the -D_POSIX_C_SOURCE macro with a value >= 200112.

EXTERNAL INFLUENCES

Environment Variables

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 constitute 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 defined.

AUTHOR

btowc() was developed by HP and Mitsubishi Electric Corp.