btowc(3) [netbsd man page]

BTOWC(3)						   BSD 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 current 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'').

BSD
								   March 3, 2003							       BSD

BTOWC(3)						   BSD Library Functions Manual 						  BTOWC(3)

NAME

     btowc, btowc_l, wctob, wctob_l -- convert between wide and single-byte characters

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

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

     wint_t
     btowc(int c);

     int
     wctob(wint_t c);

     #include <wchar.h>
     #include <xlocale.h>

     wint_t
     btowc_l(int c, locale_t loc);

     int
     wctob_l(wint_t c, locale_t loc);

DESCRIPTION

     The btowc() function converts a single-byte character into a corresponding wide character.  If the character is EOF or not valid in the ini-
     tial shift state, btowc() returns WEOF.

     The wctob() function converts a wide character into a corresponding single-byte character.  If the wide character is WEOF or not able to be
     represented as a single byte in the initial shift state, wctob() returns WEOF.

     While the btowc() and wctob() functions use the current locale, the btowc_l() and wctob_l() functions may be passed locales directly. See
     xlocale(3) for more information.

LEGACY SYNOPSIS

     The include file <stdio.h> is not necessary for these functions.

SEE ALSO

     mbrtowc(3), multibyte(3), wcrtomb(3), xlocale(3), compat(5)

STANDARDS

     The btowc() and wctob() functions conform to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

     The btowc() and wctob() functions first appeared in FreeBSD 5.0.

BSD
								  August 3, 2002							       BSD