btowc(3c) [hpux man page]

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)

btowc(3)						     Library Functions Manual							  btowc(3)

NAME

       btowc - Converts a single byte from multibyte-character to wide-character format

LIBRARY

       Standard C Library (libc)

SYNOPSIS

       #include <stdio.h> #include <wchar.h>

       wint_t btowc(
	       int c );

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       btowc(): ISO C, XSH5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Points to a variable containing a single-byte character.

DESCRIPTION

       The  btowc()  function determines if a single-byte value constitutes a valid character in the initial shift state from a multibyte codeset.
       If so, the function returns the corresponding wide-character value.  This function provides a multibyte-character to wide-character  format
       conversion  correctly  sized for the %c conversion specifier that is permitted in calls to *printf() functions.	In general, use either the
       mbtowc() or mbrtowc() function to perform multibyte-character to wide-character format conversions of single characters.

RETURN VALUES

       The btowc() function returns one of the following: The counterpart wide-character value, if c contains a valid multibyte character  in  the
       initial shift state WEOF, if c contains EOF or does not constitute a valid character in the initial shift state from a multibyte codeset

ERRORS

       No errors are defined.

RELATED INFORMATION

       Functions: mblen(3), mbtowc(3), wctob(3), wctomb(3), mbstowcs(3), wcstombs(3)

       Files: locale(4) delim off

																	  btowc(3)