getwc.3c (2010 09)

getwc(3C) getwc(3C)

[EINTR] The read operation was terminated due to the receipt of a signal, and either no data was

transferred or the implementation does not report partial transfer for this ﬁle.

[EIO] A physical I/O error has occurred, or the process is a member of a background process

and is attempting to read from its controlling terminal, and either the process is ignoring

or blocking the

SIGTTIN signal or the process group of the process is orphaned.

[EILSEQ] The data obtained from the input stream does not form a valid wide character.

Additional

errno values may be set by the underlying

read() function (see read (2)).

EXTERNAL INFLUENCES

Environment Variables

LC_CTYPE category determines how wide-character conversions are done.

International Code Set Support

Single- and multibyte character code sets are supported.

WARNINGS

If the value returned by

getwc(), getwchar()

, fgetwc(),orfgetwc_unlocked()

is stored into

a type

wchar_t variable then compared against the constant

WEOF, the comparison may never succeed

because extension of a

wchar_t to a wint_t is machine-dependent.

getwc_unlocked(),

getwchar_unlocked() and fgetwc_unlocked()

are obsolescent inter-

faces supported only for compatibility with existing DCE applications. New multithreaded applications

should use

getwc(), getwchar() and fgetwc().

AUTHOR

getwc() was developed by OSF and HP.