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.
STANDARDS
The btowc() function conforms to ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”).