Documentation Archive Developer
Search
ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



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 corresponding
     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 single-byte
     gle-byte character.  If the wide character is WEOF or not able to be rep-resented represented
     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