/* * 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, * and/or 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 INDEX _getc_r SYNOPSIS #include int getc(FILE *<[fp]>); #include int getc( 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 <>. The <<_getc_r>> function is simply the reentrant version of <> which passes an additional reentrancy structure pointer argument: <[ptr]>. 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: <>, <>, <>, <>, <>, <>, <>. */ #if defined(LIBC_SCCS) && !defined(lint) static char sccsid[] = "%W% (Berkeley) %G%"; #endif /* LIBC_SCCS and not lint */ #define _DEFAULT_SOURCE #include <_ansi.h> #include #include "local.h" /* * A subroutine version of the macro getc. */ #undef getc int getc ( register FILE *fp) { int result; CHECK_INIT (ptr, fp); _newlib_flockfile_start (fp); result = _sgetc ( fp); _newlib_flockfile_end (fp); return result; }