Next: , Previous: , Up: Stdio   [Contents][Index]


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