NAME    [Toc]    [Back]

       getwchar - read a wide character from standard input

SYNOPSIS    [Toc]    [Back]

       #include <wchar.h>

       wint_t getwchar (void);

DESCRIPTION    [Toc]    [Back]

       The  getwchar  function is the wide-character equivalent of the getchar
       function. It reads a wide character from stdin and returns it.  If  the
       end  of stream is reached, or if ferror(stdin) becomes true, it returns
       WEOF. If a wide character conversion error occurs,  it  sets  errno  to
       EILSEQ and returns WEOF.

RETURN VALUE    [Toc]    [Back]

       The  getwchar  function	returns  the next wide-character from standard
       input, or WEOF.

CONFORMING TO    [Toc]    [Back]

       ISO/ANSI C, UNIX98

SEE ALSO    [Toc]    [Back]

       fgetwc(3)

NOTES    [Toc]    [Back]

       The behaviour of getwchar depends on the LC_CTYPE category of the  current
 locale.

       It is reasonable to expect that getwchar will actually read a multibyte
       sequence from standard input and then convert it to a wide character.



GNU				  1999-07-25			   GETWCHAR(3)