BTOWC(3) | Library Functions Manual | BTOWC(3) |
btowc
, btowc_l
,
wctob
, wctob_l
—
convert between wide and single-byte characters
Standard C Library (libc, -lc)
#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);
The
btowc
()
function converts a single-byte character into a corresponding 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 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.
The include file
<stdio.h>
is not necessary
for these functions.
The btowc
() and
wctob
() functions conform to IEEE
Std 1003.1-2001 (“POSIX.1”).
The btowc
() and
wctob
() functions first appeared in
FreeBSD 5.0.
August 3, 2002 | macOS 14.6 |