getwc(3S)							     getwc(3S)

NAME    [Toc]    [Back]

     getwc, getwchar, fgetwc  -	get wchar_t character or word from a stream

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>
     #include <widec.h>

     int getwc(FILE *stream);
     int getwchar(void);

     int fgetwc(FILE *stream);

DESCRIPTION (International Functions)    [Toc]    [Back]

     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    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

     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    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111