getwc(3S)                                                            getwc(3S)


NAME
     getwc, getwchar, fgetwc  - get wchar_t character or word 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, but is a function.

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

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

NOTES
     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.


                                                                        Page 1