diff options
Diffstat (limited to 'newlib/libc/stdio/getwchar.c')
-rw-r--r-- | newlib/libc/stdio/getwchar.c | 41 |
1 files changed, 4 insertions, 37 deletions
diff --git a/newlib/libc/stdio/getwchar.c b/newlib/libc/stdio/getwchar.c index 7ab230a4c..f559c7677 100644 --- a/newlib/libc/stdio/getwchar.c +++ b/newlib/libc/stdio/getwchar.c @@ -26,65 +26,34 @@ /* FUNCTION -<<getwchar>>, <<getwchar_unlocked>>---read a wide character from standard input +<<getwchar>>---read a wide character from standard input INDEX getwchar INDEX - getwchar_unlocked -INDEX _getwchar_r -INDEX - _getwchar_unlocked_r ANSI_SYNOPSIS #include <wchar.h> wint_t getwchar(void); - #define _GNU_SOURCE - #include <wchar.h> - wint_t getwchar_unlocked(void); - - #include <wchar.h> wint_t _getwchar_r(struct _reent *<[reent]>); - #include <wchar.h> - wint_t _getwchar_unlocked_r(struct _reent *<[reent]>); - TRAD_SYNOPSIS #include <wchar.h> wint_t getwchar(); - #define _GNU_SOURCE - #include <wchar.h> - wint_t getwchar_unlocked(); - - #include <wchar.h> wint_t _getwchar_r(<[reent]>) char * <[reent]>; - #include <wchar.h> - wint_t _getwchar_unlocked_r(<[reent]>) - char * <[reent]>; - DESCRIPTION <<getwchar>> function or macro is the wide character equivalent of the <<getchar>> function. You can use <<getwchar>> to get the next wide character from the standard input stream. As a side effect, <<getwchar>> advances the standard input's current position indicator. -<<getwchar_unlocked>> is a non-thread-safe version of <<getwchar>>. -<<getwchar_unlocked>> may only safely be used within a scope -protected by flockfile() (or ftrylockfile()) and funlockfile(). This -function may safely be used in a multi-threaded program if and only -if they are called while the invoking thread owns the (FILE *) -object, as is the case after a successful call to the flockfile() or -ftrylockfile() functions. If threads are disabled, then -<<getwchar_unlocked>> is equivalent to <<getwchar>>. - -The alternate functions <<_getwchar_r>> and <<_getwchar_unlocked_r>> are -reentrant versions of the above. The extra argument <[reent]> is a pointer to -a reentrancy structure. +The alternate function <<_getwchar_r>> is a reentrant version. The +extra argument <[reent]> is a pointer to a reentrancy structure. RETURNS The next wide character cast to <<wint_t>>, unless there is no more @@ -95,9 +64,7 @@ You can distinguish the two situations that cause an <<WEOF>> result by using `<<ferror(stdin)>>' and `<<feof(stdin)>>'. PORTABILITY -<<getwchar>> is required by C99. - -<<getwchar_unlocked>> is a GNU extension. +C99 */ #include <_ansi.h> |