Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
BTOWC(3)	       FreeBSD Library Functions Manual		      BTOWC(3)

NAME
     btowc, wctob -- convert between wide and single-byte characters

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #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
     EOF.

     The _l-suffixed versions take an explicit locale argument,	while the non-
     suffixed versions use the current global or per-thread locale.

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

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.

FreeBSD	10.1		       February	13, 2012		  FreeBSD 10.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | SEE ALSO | STANDARDS | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=btowc&sektion=3&manpath=FreeBSD+10.0-RELEASE>

home | help