btowc(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
BTOWC(3)                NetBSD Library Functions Manual               BTOWC(3)


NAME

     btowc -- convert a single byte character to a wide character


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <wchar.h>

     wint_t
     btowc(int c);


DESCRIPTION

     The btowc() function converts a single byte character c in the initial
     shift state of the current locale to a corresponding wide character.

     The behaviour of btowc() is affected by the LC_CTYPE category of the cur-
     rent locale.


RETURN VALUES

     The btowc() function returns:

     WEOF          If c is EOF or if (unsigned char) c does not correspond to
                   a valid single byte character representation.

     (otherwise)   A wide character corresponding to c.


ERRORS

     No errors are defined.


SEE ALSO

     mbrtowc(3), setlocale(3), wctob(3)


STANDARDS

     The btowc() function conforms to ISO/IEC 9899/AMD1:1995 (``ISO C90,
     Amendment 1'').

NetBSD 4.0                       March 3, 2003                      NetBSD 4.0