FGETWC(3)

NAME
4.13 `fgetwc', `getwc'--get a wide character from a file or stream

SYNOPSIS
     #include <stdio.h>
     #include <wchar.h>
     wint_t fgetwc(FILE *FP);
     #include <stdio.h>
     #include <wchar.h>
     wint_t _fgetwc_r(struct _reent *PTR, FILE *FP);
     #include <stdio.h>
     #include <wchar.h>
     wint_t getwc(FILE *FP);
     #include <stdio.h>
     #include <wchar.h>
     wint_t _getwc_r(struct _reent *PTR, FILE *FP);

DESCRIPTION
Use `fgetwc' to get the next wide character from the file or stream identified by FP. As a side effect, `fgetwc' advances the file's current position indicator.
   The `getwc' function or macro functions identically to `fgetwc'. It may be implemented as a macro, and may evaluate its argument more than once. There is no reason ever to use it.
   `_fgetwc_r' and `_getwc_r' are simply reentrant versions of `fgetwc' and `getwc' that are passed the additional reentrant structure pointer argument: PTR.

RETURNS
The next wide character cast to `wint_t'), unless there is no more data, or the host system reports a read error; in either of these situations, `fgetwc' and `getwc' return `WEOF'.
   You can distinguish the two situations that cause an `EOF' result by using the `ferror' and `feof' functions.

PORTABILITY
C99, POSIX.1-2001

SEE ALSO
fgetwc is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.