getwc(3W)                      27 Jan 1992                        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. getwc() also increments the
     file pointer, if defined, by one EUC character in the stream.
     getwchar() is defined as getwc(stdin). getwc() and getwchar() are mac-
     ros.

     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, errno is set to EILSEQ.

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

NOTES
     These functions can support either typedef unsigned short wchart or
     typedef long wchart conditionally, see mbchar(3W).

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


















Page 1                       Reliant UNIX 5.44                      1, 1927