Index for Section 3

Alphabetical listing for B

Bottom of page

btowc(3)
NAME
  btowc - Convert a single byte from multibyte-character to wide-character
  format

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

  wint_t btowc(
	  int c );

LIBRARY
  Standard C Library (libc)

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
  *c  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.

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

  Files: locale(4)

Index for Section 3

Alphabetical listing for B

Top of page