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

NAME
     bbttoowwcc, wwccttoobb, bbttoowwccll, wwccttoobbll - convert between wide and single-byte
     characters

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     wintt
     bbttoowwcc(int c);

     int
     wwccttoobb(wintt c);

     ##iinncclluuddee <>

     wintt
     bbttoowwccll(int c, localet loc);

     int
     wwccttoobbll(wintt c, localet loc);

DESCRIPTION
     The bbttoowwcc() 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, bbttoowwcc() returns WEOF.

     The wwccttoobb() 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, wwccttoobb() returns
     WEOF.

     While the bbttoowwcc() and wwccttoobb() functions use the current locale, the
     bbttoowwccll() and wwccttoobbll() functions may be passed locales directly. See
     xlocale(3) for more information.

SEE ALSO
     mbrtowc(3), multibyte(3), wcrtomb(3), xlocale(3)

STANDARDS
     The bbttoowwcc() and wwccttoobb() functions conform to IEEE Std 1003.1-2001
     (``POSIX.1'').

HISTORY     The bbttoowwcc() and wwccttoobb() functions first appeared in FreeBSD 5.0.

BSD                             August 3, 2002                             BSD