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 correspond-
ing wide character. If the character is EOF or not valid in the initial
shift state, btowc() returns WEOF.
The wctob() function converts a wide character into a corresponding sin-
gle-byte character. If the wide character is WEOF or not able to be rep-
resented 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
Mac OS X 10.5 - Generated Sun Oct 28 21:26:53 EDT 2007