GETWC(3W-SVR4)      RISC/os Reference Manual       GETWC(3W-SVR4)



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


















                        Printed 11/19/92                   Page 1