fgetc
int  fgetc (FILE * stream);
stdio.h
  cplusplus.com  

Get the next character from a stream.
Returns the next character of the stream and increases the file pointer to point to the following one.

Parameters.

stream
pointer to an open file.

Return Value.
  The character read is returned. If the End Of File is reached or there has been an error reading, function returns an EOF character.
  The character is read as unsigned char and returned as int.
  Note that when you work with binary files EOF is a valid character and you should use feof() function to check if End Of File has really been reached.
  EOF can also indicate an error while reading, use ferror() to check if an error has occurred.

Portability.
  Defined in ANSI-C.

Example.

/* fgetc example: money counter */
#include <stdio.h>
main ()
{
  FILE * pFile;
  char c;
  int n = 0;
  pFile=fopen ("myfile.txt","r");
  if (pFile==NULL) perror ("Error opening file");
  else
  {
    do {
      c = fgetc (pFile);
      if (c == '$') n++;
    } while (c != EOF);
    fclose (pFile);
    printf ("File contains %d$.\n",n);
  }
  return 0;
}
  This program reads existing file myfile.txt character by character and uses the n variable to count how many dollar characters ($) does the file contain.

See also.
  fputc, fread, fwrite


© The C++ Resources Network, 2000