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 character 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