GETWCHAR(3) NEWLIB GETWCHAR(3)NAME
4.40 `getwchar'--read a wide character from standard input
SYNOPSIS
#include <wchar.h>
wint_t getwchar(void);
wint_t _getwchar_r(struct _reent *REENT);
DESCRIPTION
`getwchar' function or macro is the wide character equivalent of the
`getchar' function. You can use `getwchar' to get the next wide char‐
acter from the standard input stream. As a side effect, `getwchar'
advances the standard input's current position indicator.
The alternate function `_getwchar_r' is a reentrant version. The
extra argument REENT is a pointer to a reentrancy structure.
RETURNS
The next wide character cast to `wint_t', unless there is no more data,
or the host system reports a read error; in either of these situations,
`getwchar' returns `WEOF'.
You can distinguish the two situations that cause an `WEOF' result
by using ``ferror(stdin)'' and ``feof(stdin)''.
PORTABILITY
C99
SEE ALSOgetwchar is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 GETWCHAR(3)