osf1 man page for btowc

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)