C++ Reference: Standard C++ Library reference: C Library: cstdio: getc

C++官网参考链接：https://cplusplus.com/reference/cstdio/getc/

函数 

getc
int getc ( FILE * stream );
从流中获取字符
返回指定stream的内部文件位置指示符当前所指向的字符。然后将内部文件位置指示符向前移动到下一个字符。
如果调用时stream位于文件结束，则函数返回EOF并为stream设置文件结束指示符（feof）。
如果发生读错误，该函数返回EOF并为stream设置错误指示符（ferror）。
getc和fgetc是等价的，除了getc可能在某些库中作为宏实现。有关直接从stdin读取的类似函数，请参阅getchar。

形参
stream 
指向标识输入流的FILE对象的指针。
因为有些库可能将此函数作为宏实现，并且这可能对stream表达式求值不止一次，因此这应该是一个没有副作用的表达式。

返回值
如果成功，则返回已读取的字符（提升为int值）。
返回类型是int，以适应特殊值EOF，这表示失败： 
如果位置指示符位于文件结束，该函数返回EOF并设置stream的文件结束指示符（feof）。
如果发生其他读错误，该函数也返回EOF，但设置其错误指示符（ferror）。 

用例
/* getc example: money counter */
#include
int main ()
{
  FILE * pFile;
  int c;
  int n = 0;
  pFile=fopen ("myfile.txt","r");
  if (pFile==NULL) perror ("Error opening file");
  else
  {
    do {
      c = getc (pFile);
      if (c == '$') n++;
    } while (c != EOF);
    fclose (pFile);
    printf ("File contains %d$.\n",n);
  }
  return 0;
}
这个程序逐字符读取一个名为myfile.txt的现有文件，并使用n变量计算文件包含多少美元字符（$）。
另请参考
fgetc    Get character from stream (function)
fputc    Write character to stream (function)
fread    Read block of data from stream (function)
fwrite    Write block of data to stream (function)