getwc(3W) DG/UX R4.11MU05 getwc(3W)
NAME
getwc, getwchar, fgetwc - get next wide character from a stream
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
wintt getwc(FILE *stream);
wintt getwchar(void);
wintt fgetwc(FILE *stream);
DESCRIPTION
fgetwc transforms the next multibyte character from the named input
stream into a wide character, and returns it. It also increments the
file pointer, if defined, by one multibyte character. getwchar is
defined as getwc(stdin).
getwc behaves like fgetwc, except that getwc may be implemented as a
macro which evaluates stream more than once.
Errors
These functions return the constant WEOF and sets the stream's end-
of-file indicator at the end-of-file. They return WEOF if an error
is found. If the error is an I/O error, the error indicator is set.
If it is due to an invalid or incomplete multibyte character, errno
is set to EILSEQ.
Considerations for Threads Programming
+---------+-----------------------------+
| | async- |
|function | reentrant cancel cancel |
| | point safe |
+---------+-----------------------------+
|fgetwc | Y N N |
|getwc | Y N N |
|getwchar | Y N N |
+---------+-----------------------------+
REFERENCES
reentrant(3), fclose(3S), ferror(3S), fopen(3S), scanf(3S),
stdio(3S), getws(3W), putwc(3W)
NOTICES
If the value returned by getwc, getwchar, or fgetwc is compared with
the integer constant WEOF after being stored in a wchart object, the
comparison may not succeed.
Licensed material--property of copyright holder(s)