FGETWC
NAME
fgetwc, getwc - read a wide character from a FILE stream
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
I wint_t fgetwc(FILE * stream );
I wint_t getwc(FILE * stream );
DESCRIPTION
The
R fgetwc ()
function is the wide-character equivalent
of the
fgetc(3)
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
R getwc ()
function or macro functions identically to
R fgetwc ().
It may be implemented as a macro, and may evaluate its argument
more than once.
There is no reason ever to use it.
RETURN VALUE
The
R 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
C99, POSIX.1-2001.
NOTES
The behavior of
R fgetwc ()
depends on the
LC_CTYPE
category of the
current locale.
In the absence of additional information passed to the
fopen(3)
call, it is
reasonable to expect that
R fgetwc ()
will actually read a multibyte sequence
from the stream and then convert it to a wide character.
SEE ALSO
ČLÁNKY DO MAILU