getwchar — read a wide character from standard input
#include <wchar.h>
wint_t getwchar( |
void) ; |
The getwchar
() function is
the wide-character equivalent of the getchar(3) 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
.
For a non-locking counterpart, see unlocked_stdio(3).
The behavior 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.
This page is part of release 2.79 of the Linux man-pages
project. A
description of the project, and information about reporting
bugs, can be found at
http://www.kernel.org/doc/man-pages/.
Copyright (c) Bruno Haible <haibleclisp.cons.org> This is free documentation; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. References consulted: GNU glibc-2 source code and manual Dinkumware C library reference http://www.dinkumware.com/ OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html ISO/IEC 9899:1999 |