getwc(3W)                      DG/UX 5.4R3.00                      getwc(3W)


NAME
       getwc, getwchar, fgetwc - get wchart 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 wchart 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.

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

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

























Licensed material--property of copyright holder(s)                         1