diff -r 000000000000 -r e4d67989cc36 genericopenlibs/cstdlib/LSTDIO/GETCHAR.C --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/genericopenlibs/cstdlib/LSTDIO/GETCHAR.C Tue Feb 02 02:01:42 2010 +0200 @@ -0,0 +1,110 @@ +/* GETCHAR.C + * + * Portions Copyright (c) 1990-2006 Nokia Corporation and/or its subsidiary(-ies). + * All rights reserved. + */ + +/* + * Copyright (c) 1990 The Regents of the University of California. + * All rights reserved. + * + * Redistribution and use in source and binary forms are permitted + * provided that the above copyright notice and this paragraph are + * duplicated in all such forms and that any documentation, + * advertising materials, and other materials related to such + * distribution and use acknowledge that the software was developed + * by the University of California, Berkeley. The name of the + * University may not be used to endorse or promote products derived + * from this software without specific prior written permission. + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. + */ + +/* +FUNCTION +<>---read a character (macro) + +INDEX + getchar +INDEX + _getchar_r + +ANSI_SYNOPSIS + #include + int getchar(void); + + int _getchar_r(void *<[reent]>); + +TRAD_SYNOPSIS + #include + int getchar(); + + int _getchar_r(<[reent]>) + char * <[reent]>; + +DESCRIPTION +<> is a macro, defined in <>. You can use <> +to get the next single character from the standard input stream. +As a side effect, <> advances the standard input's +current position indicator. + +The alternate function <<_getchar_r>> is a reentrant version. The +extra argument <[reent]> is a pointer to a reentrancy structure. + + +RETURNS +The next character (read as an <>, and cast to +<>), unless there is no more data, or the host system reports a +read error; in either of these situations, <> returns <>. + +You can distinguish the two situations that cause an <> result by +using `<>' and `<>'. + +PORTABILITY +ANSI C requires <>; it suggests, but does not require, that +<> be implemented as a macro. + +Supporting OS subroutines required: <>, <>, <>, +<>, <>, <>, <>. +*/ + +/* + * A subroutine version of the macro getchar. + */ + +#include +#include + +#undef getchar + +/** +A reentrant version of getchar(). +*/ +EXPORT_C int +_getchar_r (struct _reent *f) +{ + return getc (_stdin_r (f)); +} + +#ifndef _REENT_ONLY + +/** +Get the next character from stdin.Returns the next character from the +standard input. + +@return On Success, the character read is returned as an int. + On Failure, returns EOF, if the 'End Of File' is reached or there has + been an error reading and errno may be set. +*/ +EXPORT_C int +getchar (void) +{ + /* CHECK_INIT is called (eventually) by __srefill. */ + struct _reent *r = _REENT2; + if (!r) + return EOF; // Memory for library globals is not allocated (errno not set). + return _getchar_r (r); +} + +#endif