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(3C)						   Standard C Library Functions 						 btowc(3C)

NAME

       btowc - single-byte to wide-character conversion

SYNOPSIS

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

       wint_t btowc(int c);

DESCRIPTION

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

       The behavior of this function is affected by the LC_CTYPE category of the current locale.  See environ(5).

RETURN VALUES

       The  btowc()  function  returns WEOF if c has the value EOF or if  (unsigned char)c does not constitute a valid (one-byte) character in the
       initial shift state.  Otherwise, it returns the wide-character representation of that character.

ERRORS

       No errors are defined.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe with exceptions	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       setlocale(3C), wctob(3C), attributes(5), environ(5), standards(5)

NOTES

       The btowc() function can be used safely in multithreaded applications, as long as setlocale(3C) is not being called to change the locale.

SunOS 5.11							    24 Jul 2002 							 btowc(3C)