btowc(3) [osf1 man page]

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)

wctob(3)						     Library Functions Manual							  wctob(3)

NAME

       wctob - Converts a wide character to a single byte in multibyte-character format

LIBRARY

       Standard C Library (libc)

SYNOPSIS

       #include <stdlib.h> #include <wchar.h>

       int wctob(
	       wint_t wc );

STANDARDS

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

       wctob():  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 wide-character value.

DESCRIPTION

       The  wctob()  function  determines  if  a  wide-character value constitutes a valid single-byte character in the initial shift state from a
       multibyte codeset. If so, the function returns the corresponding multibyte character.  This function provides a	wide-character	to  multi-
       byte-character format conversion correctly sized for the %c conversion specifier that is permitted in calls to *printf() functions.

       In  general,  use  either  the wctomb() or wcrtomb() function to perform wide-character to multibyte-character format conversions of single
       characters. Converting only the characters whose encoding requires one byte has limited usefulness in multibyte codesets, where	codes  for
       many or most characters require multiple bytes.

RETURN VALUES

       The  wctob() function returns one of the following: The counterpart multibyte-character value, if wc can be converted to a multibyte-format
       character that is 1 byte in length and in the initial shift state EOF, if wc does not correspond to a valid multibyte character that  is  1
       byte in length and in the initial shift state

ERRORS

       The wctob() function sets errno to the specified value for the following conditions: An invalid character value is encountered.

RELATED INFORMATION

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

       Files: locale(4) delim off

																	  wctob(3)