HPlogo HP-UX Reference > B

btowc(3C)

HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

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.

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