Reference

btowc(3)

convert between wide and single-byte characters

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 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.

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.

History