Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

BTOWC(3)                   Library Functions Manual                   BTOWC(3)

NAME
     btowc - convert a single byte character to a wide character

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <wchar.h>

     wint_t
     btowc(int c);

DESCRIPTION
     The btowc() function converts a single byte character c in the initial
     shift state of the current locale to a corresponding wide character.

     The behaviour of btowc() is affected by the LC_CTYPE category of the
     current locale.

RETURN VALUES
     The btowc() function returns:

     WEOF          If c is EOF or if (unsigned char) c does not correspond to
                   a valid single byte character representation.

     (otherwise)   A wide character corresponding to c.

ERRORS
     No errors are defined.

SEE ALSO
     mbrtowc(3), setlocale(3), wctob(3)

STANDARDS
     The btowc() function conforms to ISO/IEC 9899/AMD1:1995 ("ISO C90,
     Amendment 1").

NetBSD 10.99                     March 3, 2003                    NetBSD 10.99