getwc(3C)
NAME
getwc - get wide character from a stream
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
wint_t getwc(FILE *stream);
DESCRIPTION
The getwc() function is equivalent to fgetwc(3C), except
that if it is implemented as a macro it may evaluate stream
more than once, so the argument should never be an expres-
sion with side effects.
RETURN VALUES
Refer to fgetwc(3C).
ERRORS
Refer to fgetwc(3C).
USAGE
This interface is provided to align with some current imple-
mentations and with possible future ISO standards.
Because it may be implemented as a macro, getwc() may treat
incorrectly a stream argument with side effects. In partic-
ular, getwc(*f++) may not work as expected. Therefore, use
of this function is not recommended; fgetwc(3C) should be
used instead.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| MT-Level | MT-Safe |
|_____________________________|_____________________________|
SEE ALSO
fgetwc(3C), attributes(5)
Man(1) output converted with
man2html