HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

getwc(3C) getwc(3C)

[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

Locale

The

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.