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)