FGETWC(3) NEWLIB 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 cur‐
rent 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 situ‐
ations, `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 ALSOfgetwc is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 FGETWC(3)