getc(3p) - phpMan

GETC(P)                                                                GETC(P)



NAME
       getc - get a byte from a stream

SYNOPSIS
       #include <stdio.h>

       int getc(FILE *stream);


DESCRIPTION
       The  getc()  function  shall be equivalent to fgetc() , except that if it is imple-
       mented as a macro it may evaluate stream more than once,  so  the  argument  should
       never be an expression with side effects.

RETURN VALUE
       Refer to fgetc() .

ERRORS
       Refer to fgetc() .

       The following sections are informative.

EXAMPLES
       None.

APPLICATION USAGE
       If  the integer value returned by getc() is stored into a variable of type char and
       then compared against the integer constant EOF, the comparison may  never  succeed,
       because  sign-extension of a variable of type char on widening to integer is imple-
       mentation-defined.

       Since it may be implemented as a macro, getc() may treat incorrectly a stream argu-
       ment  with  side  effects.  In  particular, getc(*f++) does not necessarily work as
       expected.  Therefore, use of this function should be preceded by "#undef  getc"  in
       such situations; fgetc() could also be used.

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       fgetc() , the Base Definitions volume of IEEE Std 1003.1-2001, <stdio.h>

COPYRIGHT
       Portions of this text are reprinted and reproduced in electronic form from IEEE Std
       1003.1, 2003 Edition, Standard for Information  Technology  --  Portable  Operating
       System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C)
       2001-2003 by the Institute of Electrical and Electronics  Engineers,  Inc  and  The
       Open  Group.  In the event of any discrepancy between this version and the original
       IEEE and The Open Group Standard, the original IEEE and The Open Group Standard  is
       the   referee   document.   The   original  Standard  can  be  obtained  online  at
       http://www.opengroup.org/unix/online.html .



POSIX                                2003                              GETC(P)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-09 06:56 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)