fgetwc - read a wide character from a FILE stream
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
wint_t fgetwc (FILE* stream);
wint_t getwc (FILE* stream);
DESCRIPTION
The fgetwc function is the wide-character equivalent of
the fgetc function. It reads a wide character from stream
and returns it. If the end of stream is reached, or if
ferror(stream) becomes true, it returns WEOF. If a wide
character conversion error occurs, it sets errno to EILSEQ
and returns WEOF.
The getwc function or macro functions identically to
fgetwc. It may be implemented as a macro, and may evalu
ate its argument more than once. There is no reason ever
to use it.
RETURN VALUE
The fgetwc function returns the next wide-character from
the stream, or WEOF.
ERRORS
Apart from the usual ones, there is
EILSEQ The data obtained from the input stream does not
form a valid character.
CONFORMING TO
ISO/ANSI C, UNIX98
SEE ALSO
fputwc(3), fgetws(3), ungetwc(3)
NOTES
The behaviour of fgetwc depends on the LC_CTYPE category
of the current locale.
In the absence of additional information passed to the
fopen call, it is reasonable to expect that fgetwc will
actually read a multibyte sequence from the stream and
then convert it to a wide character.
Man(1) output converted with
man2html