btowc(3) - Manual pages

NAME

btowc — convert a single byte character to a wide character

library “libc”

#include <wchar.h>

wint_t
btowc(int c);

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.

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.

No errors are defined.

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