diff options
Diffstat (limited to 'newlib/libc/stdio/getwchar.c')
-rw-r--r-- | newlib/libc/stdio/getwchar.c | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/newlib/libc/stdio/getwchar.c b/newlib/libc/stdio/getwchar.c new file mode 100644 index 0000000..c55bf1b --- /dev/null +++ b/newlib/libc/stdio/getwchar.c @@ -0,0 +1,93 @@ +/*- + * Copyright (c) 2002 Tim J. Robbins. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +/* +FUNCTION +<<getwchar>>---read a wide character from standard input + +INDEX + getwchar +INDEX + _getwchar_r + +ANSI_SYNOPSIS + #include <wchar.h> + wint_t getwchar(void); + + wint_t _getwchar_r(struct _reent *<[reent]>); + +TRAD_SYNOPSIS + #include <wchar.h> + wint_t getwchar(); + + wint_t _getwchar_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. + +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 +data, or the host system reports a read error; in either of these +situations, <<getwchar>> returns <<EOF>>. + +You can distinguish the two situations that cause an <<EOF>> result by +using `<<ferror(stdin)>>' and `<<feof(stdin)>>'. + +PORTABILITY +C99 +*/ + +#include <_ansi.h> +#include <reent.h> +#include <stdio.h> +#include <wchar.h> +#include "local.h" + +#undef getwchar + +wint_t +_DEFUN (_getwchar_r, (ptr), + struct _reent *ptr) +{ + return _fgetwc_r (ptr, stdin); +} + +/* + * Synonym for fgetwc(stdin). + */ +wint_t +_DEFUN_VOID (getwchar) +{ + _REENT_SMALL_CHECK_INIT (_REENT); + return fgetwc (stdin); +} |