GETWCHAR(3C)            Standard C Library Functions            GETWCHAR(3C)
NAME
       getwchar - get wide character from stdin stream
SYNOPSIS
       #include <wchar.h>       
wint_t getwchar(void)
       #include <wchar.h>
       #include <xlocale.h>       
wint_t getwchar_l(locale_t loc)
DESCRIPTION
       The 
getwchar() function is equivalent to 
getwc(
stdin).
       The 
getwchar_l() function is equivalent to 
getwc(
stdin, 
loc).
RETURN VALUES
       Refer to 
fgetwc(3C).
ERRORS
       Refer to 
fgetwc(3C).
USAGE
       If the 
wint_t value returned by 
getwchar() is stored into a variable
       of type 
wchar_t and then compared against the 
wint_t macro 
WEOF, the
       comparison may never succeed because 
wchar_t is defined as unsigned.
ATTRIBUTES
       See 
attributes(7) for descriptions of the following attributes:
       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Interface Stability | See below.      |
       +--------------------+-----------------+
       |MT-Level            | MT-Safe         |
       +--------------------+-----------------+
       The 
getwchar() function is Standard.  The 
getwchar_l() function is
       Uncommitted.
SEE ALSO
       fgetwc(3C), 
getwc(3C), 
attributes(7), 
standards(7)                                June 20, 2021                   GETWCHAR(3C)