NAME

getwc, getwchar, fgetwc − get wchar_t character from a stream

SYNOPSIS

#include <stdio.h>
#include <widec.h> int getwc(FILE ∗stream); int getwchar(void); int fgetwc(FILE ∗stream);

DESCRIPTION (International Functions)

getwc() transforms the next EUC character from the named input stream into a wchar_t character, and returns it It also increments the file pointer, if defined, by one EUC character in the stream.  getwchar() is defined as getwc(stdin).  getwc() and getwchar() are macros. 

fgetwc() behaves like getwc(), however, it is a function. 

DIAGNOSTICS

These functions return the constant EOF at the end-of-file or upon an error and set the EOF or error indicator of stream, respectively.  If the error is an illegal sequence, EILSEQ is set to errno. 

WARNINGS

If the value returned by getwc(), getwchar(), or fgetwc() is compared with the integer constant EOF after being stored in a wchar_t variable, the comparison may not succeed unless EOF is cast to type wchar_t. 

SEE ALSO

fclose(3S), ferror(3S), fopen(3S), getws(3W), putwc(3W), scanf(3S), scanf(3W), stdio(3S).  widec(3W).