Index for Section 3

Alphabetical listing for W

Bottom of page

wctob(3)
NAME
  wctob - Convert a wide character to a single byte in multibyte-character
  format

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

  int wctob(
	  wint_t wc );

LIBRARY
  Standard C Library (libc)

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
  *wc 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 multibyte-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:

  [EILSEQ]
      An invalid character value is encountered.

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

  Files: locale(4)

Index for Section 3

Alphabetical listing for W

Top of page