diff -r e20de85af2ee -r ce057bb09d0b genericopenlibs/cstdlib/LSTDIO/GETC.C --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/genericopenlibs/cstdlib/LSTDIO/GETC.C Fri Jun 04 16:20:51 2010 +0100 @@ -0,0 +1,91 @@ +/* GETC.C + * + * Portions Copyright (c) 1990-1999 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 + getc + +ANSI_SYNOPSIS + #include + int getc(FILE *<[fp]>); + +TRAD_SYNOPSIS + #include + int getc(<[fp]>) + FILE *<[fp]>; + +DESCRIPTION +<> is a macro, defined in <>. You can use <> +to get the next single character from the file or stream +identified by <[fp]>. As a side effect, <> advances the file's +current position indicator. + +For a subroutine version of this macro, see <>. + +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 the <> and <> functions. + +PORTABILITY +ANSI C requires <>; it suggests, but does not require, that +<> be implemented as a macro. The standard explicitly permits +macro implementations of <> to use the argument more than once; +therefore, in a portable program, you should not use an expression +with side effects as the <> argument. + +Supporting OS subroutines required: <>, <>, <>, +<>, <>, <>, <>. +*/ + +#include +#include "LOCAL.H" + +/* + * A subroutine version of the macro getc. + */ + +#undef getc + +/** +Get the next character. +Returns the next character of the stream and increases the file pointer +to point to the next character. +@return The character read is returned as an int value. +If the End Of File has been reached or there has been an error reading, +the function returns EOF. +@param fp pointer to an open file. +*/ +EXPORT_C int +getc (register FILE *fp) +{ + /* CHECK_INIT is called (eventually) by __srefill. */ + + return __sgetc (fp); +}