Section: Linux Programmer's Manual (3)
fgetwc, getwc - read a wide character from a FILE stream
wint_t fgetwc(FILE *stream);
wint_t getwc(FILE *stream);
function is the wide-character equivalent
It reads a wide character from stream
and returns it.
If the end of stream is reached, or if ferror(stream)
If a wide-character conversion error occurs, it sets
function or macro functions identically to
It may be implemented as a macro, and may evaluate its argument
more than once.
There is no reason ever to use it.
For nonlocking counterparts, see
function returns the next wide-character
from the stream, or
In the event of an error,
is set to indicate the cause.
Apart from the usual ones, there is
The data obtained from the input stream does not
form a valid character.
For an explanation of the terms used in this section, see
POSIX.1-2001, POSIX.1-2008, C99.
The behavior of
depends on the
category of the
In the absence of additional information passed to the
call, it is
reasonable to expect that
will actually read a multibyte sequence
from the stream and then convert it to a wide character.
This page is part of release 5.07 of the Linux
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at