hpux man page for btowc

btowc(3C)																 btowc(3C)

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

SYNOPSIS
DESCRIPTION
       The	      function determines whether c constitutes a valid (one-byte) character in the initial shift state.

       The	      function determines whether c corresponds to a member of the extended character set whose character representation is a sin-
		      gle byte when in the initial shift state.

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

	 a. conformant.

	 b. Compiled with the macro with a value >=500.

	 c. Compiled with the macro with a value >= 200112.

EXTERNAL INFLUENCES
   Environment Variables
       The behavior of these functions is affected by the category.

RETURN VALUE
       The function returns if c has the value 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 function returns 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
       was developed by HP and Mitsubishi Electric Corp.

SEE ALSO
       thread_safety(5).

																	 btowc(3C)