NAME    [Toc]    [Back]

       btowc  - Convert a single byte from multibyte-character to
       wide-character format

SYNOPSIS    [Toc]    [Back]

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

       wint_t btowc(
               int c );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Points to a variable containing a single-byte character.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       No errors are defined.

SEE ALSO    [Toc]    [Back]

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

       Files: locale(4)



                                                         btowc(3)