C 文件操作相关类FILE 函数fopen fgets feof EOF

C 标准库 - <stdio.h>

typedef struct
{
short level; // 缓冲区“满”或“空”的程度
unsigned flags; // 文件状态标志
char fd; // 文件描述符
unsigned char hold; // 如缓冲区无内容不读取字符
short bsize; // 缓冲区的大小
unsigned char *buffer; // 数据缓冲区的位置
unsigned ar *curp; // 指针当前的指向
unsigned istemp; // 临时文件指示器
short token; // 用于有效性检查
}FILE;
例如我们定义一个文件指针：FILE *fp;

fp指向某一个文件的文件信息区（是一个结构体变量），通过该文件信息区就能够访问该文件。

fopen

作用：用来打开一个文件
格式：FILE * fopen(const char * path,const char * mode);

返回值：打开文件成功返回一个文件指针，若打开文件失败则返回NULL

*path：字符串包含欲打开的文件路径及文件名(例如：D:\\A.txt)，注意在C语言中欲输出一个"\"则需要输两个"\\" 

*mode：代表着流形态，mode有下列几种形态字符串：

            r      打开只读文件，该文件必须存在。 

            r+    打开可读写的文件，该文件必须存在。 

            rb+  读写打开一个二进制文件，只允许读写数据。

            rt+   读写打开一个文本文件，允许读和写。 

            w      打开只写文件，若文件存在则文件长度清为0，即该文件内容会消失。若文件不存在则建立该文件。  

            w+    打开可读写文件，若文件存在则文件长度清为零，即该文件内容会消失。若文件不存在则建立该文件。

            a       以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。（EOF符保留）

            a+     以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。（原来的EOF符不保留）

            wb    只写打开或新建一个二进制文件；只允许写数据。

            wb+  读写打开或建立一个二进制文件，允许读和写。  

            wt+   读写打开或着建立一个文本文件；允许读写。  

            at+    读写打开一个文本文件，允许读或在文本末追加数据。  

            ab+   读写打开一个二进制文件，允许读或在文件末追加数据。  

上述的形态字符串都可以再加一个b字符，如rb、w+b或ab＋等组合，加入b 字符用来告诉函数库打开的文件为二进制文件，而非纯文字文件。

fclose

作用：关闭一个文件流，释放文件指针

格式：int fclose( FILE *fp );

返回值：如果流成功关闭，fclose 返回 0，否则返回EOF

参数说明：

*fp：需要关闭的文件指针

注：在文件操作完成后我们应该调用该函数来关闭文件，如果不关闭文件将可能会丢失数据。因为在向文件写入数据时会先将数据输出到缓冲区，待缓冲区充满后才正式输出给文件。

fgetc

作用：从文件指针指向的文件流中读取一个字符，读取一个字节后，光标位置后移一个字节

格式：int fgetc(FILE *stream);

返回值：返回所读取的一个字节，如果读到文件末尾或者读取出错时返回EOF(EOF是文件结束标识符,一般值为-1)

参数说明：

*stream：文件指针，从该文件指针指向的文件中读取一个字符，然后将光标后移一个字节

fputc

作用：将指定字符写到文件指针所指向的文件的当前写指针位置上

格式：int fputc (char c, File *fp);

返回值：在正常调用情况下，函数返回写入文件的字符的ASCII码值，出错时，返回EOF

参数说明：

c：需要写入的字符

*fp：文件指针，在当前文件指针所指向的文件的当前写指针位置上写入一个字符c，然后文件内部写指针会自动后移一个字节位置

fgets

作用：从文件结构体指针指向的文件stream中读取数据，每次读取一行。读取的数据保存在buf指向的字符数组中，每次最多读取bufsize-1个字符（第bufsize个字符赋’\0’），如果文件中的该行，不足bufsize个字符，则读完该行就结束。如若该行（包括最后一个换行符）的字符数超过bufsize-1，则fgets只返回一个不完整的行，但是，缓冲区总是以NULL字符结尾，对fgets的下一次调用会继续读该行。

格式：char *fgets(char *buf, int bufsize, FILE *stream);

返回值：函数成功将返回buf，失败或读到文件结尾返回NULL。因此我们不能直接通过fgets的返回值来判断函数是否是出错而终止的，应该借助feof函数或者ferror函数来判断。

参数说明：

*buf: 字符型指针，指向用来存储所得数据的地址。  

bufsize: 整型数据，指明存储数据的大小。  

*stream: 文件指针，将要读取的文件流。

feof

int feof(FILE *stream); 在文件到达文件尾时给出一个非零值。

如果不是read超过文件结尾，那么feof返回的都是零。

根据数据的组织和操作形式，可以分为ASCII文件和二进制文件。

#include<stdio.h>
 #include<stdlib.h>
 
 int main()  
 { 
     FILE *fp1, *fp2; // 文件指针 
     char ch;  // 用来接收读取到的字符 
     char filename1[] = "D:\\A.txt"; // 文件A的路径,需要读取的文件，如果文件不存在则出错 
     char filename2[] = "D:\\B.txt"; // 文件B的路径，将文件A.txt读取到的数据存入当前文件 
     
     fp1=fopen(filename1, "r"); // 以只读的方式打开文件A 
     fp2=fopen(filename2, "w"); // 以只写的方式打开文件B 
     if(fp1==NULL || fp2==NULL) // 判断文件是否打开成功 
     {   //打开文件失败了 
         printf("cannot open the file!\n");  
         exit(1);  // 退出程序 需要头文件<stdlib.h>
     }
     
     //---开始--读取文件并输出到屏幕上---//
     ch=fgetc(fp1); // 读取第一个字符 
     while(ch!=EOF) // EOF即文件结束符 
     {
         putchar(ch); // 将从文件A读取到的字符输出到屏幕上 
         ch=fgetc(fp1);  // 读取下一个字符 
     }
     //---完成--读取文件并输出到屏幕上---//
     
     //---开始--读取文件A并输出到文件B里面---//
     rewind(fp1); // 将文件A的位置指针重新移到文件头
     ch=fgetc(fp1); // 读取第一个字符 
     while(ch!=EOF) // EOF即文件结束符
     {
         fputc(ch,fp2); // 将从文件A读取到的字符写入到文件B内 
         ch=fgetc(fp1);  // 读取下一个字符 
     }
     //---完成--读取文件A并输出到文件B里面---//
     
     fclose(fp1);  //关闭数据文件 
     fclose(fp2);  //关闭数据文件
     return 0;
 }

EOF是一个计算机术语，为End Of File的缩写，在操作系统中表示资料源无更多的资料可读取。资料源通常称为档案或串流。通常在文本的最后存在此字符表示资料结束。

档的结尾都有一个隐藏字符”EOF”，当程序读取它的时候，就会知道文件已经到达结尾。通常使用while循环加EOF判断作为读取结束的标志。
#define EOF (-1)

EOF是不可输出字符，因此不能在屏幕上显示。由于字符的ASCII码不可能出现-1，因此EOF定义为-1是合适的。

ASCII文件又称为文本文件，它是在一个字节的存储单元上存放一个字符（在外存中存放的是该字符的ASCII码，每个字符将占一个字节）。
二进制文件是把内存中的数据按其在内存中的存储格式在磁盘上原样保存。
对字符而言，由于其外存存储格式和内存表示格式相同，所以，在外存上也存放每个字符的ASCII码。

当读入的字符值等于EOF时，表示读入的已不是正常的字符而是文件结束符，但这适用对文本文件的读写。在二进制文件中，信息都是以数值方式存在的。EOF的值可能就是所要处理的二进制文件中的信息。这就出现了需要读入有用数据却被处理为“文件结束“的情况。为了解决这个问题，C提供了一个feof()函数，可以用它来判断文件是否结束。feof（fp）用于测试fp所指向的文件的当前状态是否为“文件结束”。如果是，函数则返回的值是1（真），否则为0（假）。

eg

文件只有四行，但是在读第五次的时候，才退出while，因为在第四次读取的时候虽然已经到了文件尾部，但没有立即设置FILE结构中的文件结束标识，因此第四次读取完之后，feof(fp)仍然返回的0。到第五次读取完之后，feof(fp)返回的才是一个非0值。

当文件内部的位置指针指向文件结束符时，并不会立即设置FILE结构中的文件结束标识，只有再执行一次读操作，才会设置文件结束标志，再调用feof()才会返回一个非0值.

#include <stdio.h>

int main ()
{
   FILE *fp;
   int c;
  
   fp = fopen("file.txt","r");
   if(fp == NULL) 
   {
      perror("打开文件时发生错误");
      return(-1);
   }
   while(1)
   {
      c = fgetc(fp);
      if( feof(fp) )
      { 
          break ;
      }
      printf("%c", c);
   }
   fclose(fp);
   return(0);
}

ref
https://blog.youkuaiyun.com/bingqing07/article/details/5785080?utm_medium=distribute.pc_relevant.none-task-blog-baidujs-2