FILE 指针的相关操作

简介

FILE是在C标准库中（stdio.h）中定义的一个结构体，通常用指针的方式保存在内存中，其内容描述了一个文件，或者说”流“更当。

文件的读写

1. 打开文件
您可以使用 fopen( ) 函数来创建一个新的文件或者打开一个已有的文件，这个调用会初始化类型 FILE 的一个对象，类型 FILE 包含了所有用来控制流的必要的信息。

FILE *fopen( const char * filename, const char * mode );

在这里，filename 是字符串，用来命名文件，访问模式 mode 的值可以是下列值中的一个：

模式	描述
r	打开一个已有的文件，允许读取
w	打开一个文件，允许写入文件。如果文件不存在，则会创建一个新的文件。从文件的开头写入内容。如果文件存在，则该内容会呗清楚，重新写入。
a	打开一个文本文件，以追加模式写入文件。如果文件不存在，则会创建一个新文件。在这里，您的程序会在已有的文件内容最后追加内容。
r+	打开一个文本文件，允许读写文件。
w+	打开一个文本文件，允许读写文件。如果文件已存在，则文件的内容会被清空，如果文件不存在，则会创建一个新文件。
a+	打开一个文本文件，允许读写文件。如果文件不存在，则会创建一个新文件。读取会从文件的开头开始，写入则只能是追加模式。

• 当文件以“a”或“a+”访问类型打开时，所有写操作都发生在文件的末尾（也就是说文件指针的位置在末尾）。可以使用fseek或倒带重新定位文件指针，但在执行任何写操作之前，总是将指针移回文件末尾。因此，现有数据不能被覆盖。
• 当指定了“r+”、“w+”或“a+”访问类型时，允许读写(该文件被称为“update”打开)。然而，当您在读和写之间切换时，必须有一个fflush、fsetpos、fseek或倒带操作。如果需要，可以为fsetpos或fseek操作指定当前位置。
• 当成功打开 读 写 文件时 指针一定在文件首，可以使用（fseek操作指定当前位置）。

“r” = “rt”
打开一个文本文件，文件必须存在，只允许读
“r+” = “rt+”
打开一个文本文件，文件必须存在，允许读写
“rb”
打开一个二进制文件，文件必须存在，只允许读
“rb+”
打开一个二进制文件，文件必须存在，允许读写
“w” = “wt”
新建一个文本文件，已存在的文件将被删除，只允许写
“w+” = “wt+”
新建一个文本文件，已存在的文件将被删除，允许读写
“wb”
新建一个二进制文件，已存在的文件将被删除，只允许写
“wb+”
新建一个二进制文件，已存在的文件将被删除，允许读写
“a” = “at”
打开或新建一个文本文件，只允许在文件末尾追写
“a+” = “at+”
打开或新建一个文本文件，可以读，但只允许在文件末尾追写
“ab”
打开或新建一个二进制文件，只允许在文件末尾追写
“ab+”
打开或新建一个二进制文件，可以读，但只允许在文件末尾追写
对于文件使用方式有以下几点说明：

1. 文件使用方式由r,w,a,t,b，+六个字符拼成，各字符的含义是：
   r(read): 只读
   w(write): 只写
   a(append): 追加
   t(text): 文本文件，可省略不写
   b(binary): 二进制文件
   +: 读和写
2. 凡用“r”打开一个文件时，该文件必须已经存在，且只能从该文件读出。
3. 用“w”打开的文件只能向该文件写入。若打开的文件不存在，则以指定的文件名建立该文件，若打开的文件已经存在，则将该文件删去，重建一个新文件。
4. 若要向一个已存在的文件追加新的信息，只能用“a”方式打开文件。如果指定文件不存在则尝试创建该文件。
5. 在打开一个文件时，如果出错，fopen将返回一个空指针值NULL。在程序中可以用这一信息来判别是否完成打开文件的工作，并作相应的处理。

2. 关闭文件

为了关闭文件，请使用 fclose( ) 函数。函数的原型如下：

int fclose( FILE *fp );

如果成功关闭文件，fclose( ) 函数返回零，如果关闭文件时发生错误，函数返回 EOF。这个函数实际上，会清空缓冲区中的数据，关闭文件，并释放用于该文件的所有内存。EOF 是一个定义在头文件 stdio.h 中的常量。

3. 写文件
把字符写入到文件中

int fputc( int c, FILE *fp );

函数 fputc() 把参数 c 的字符值写入到 fp 所指向的输出流中。如果写入成功，它会返回写入的字符，如果发生错误，则会返回 EOF。您可以使用下面的函数来把一个以 null 结尾的字符串写入到流中：

把字符串写入到文件中

int fputs( const char *s, FILE *fp );

函数 fputs() 把字符串 s 写入到 fp 所指向的输出流中。如果写入成功，它会返回一个非负值，如果发生错误，则会返回 EOF。

也可以使用 int fprintf(FILE *fp,const char *format, …) 函数来写把一个字符串写入到文件中

fprintf(fp,"%d或其他的格式化字符串",....)

还可以使用size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream) 把 ptr 所指向的数组中的数据写入到给定流 stream 中

参数

• ptr – 这是指向要被写入的元素数组的指针。
• size – 这是要被写入的每个元素的大小，以字节为单位。
• nmemb – 这是元素的个数，每个元素的大小为 size 字节。
• stream – 这是指向 FILE 对象的指针，该 FILE 对象指定了一个输出流。

返回值

如果成功，该函数返回一个 size_t 对象，表示元素的总数，该对象是一个整型数据类型。如果该数字与 nmemb 参数不同，则会显示一个错误。

4. 读文件
下面是从文件读取单个字符的最简单的函数：

int fgetc( FILE * fp );

fgetc() 函数从 fp 所指向的输入文件中读取一个字符。返回值是读取的字符，如果发生错误则返回 EOF.

下面的函数允许您从流中读取一个字符串:

char *fgets( char *buf, int n, FILE *fp );

函数 fgets() 从 fp 所指向的输入流中读取 n - 1 个字符。它会把读取的字符串复制到缓冲区 buf，并在最后追加一个 null字符来终止字符串。

如果成功，该函数返回相同的 buf 参数。如果到达文件末尾或者没有读取到任何字符，buf 的内容保持不变，并返回一个空指针。

如果发生错误，返回一个空指针。

如果这个函数在读取最后一个字符之前就遇到一个换行符 ‘\n’ 或文件的末尾 EOF，则只会返回读取到的字符，包括换行符。您也可以使用 int fscanf(FILE *fp, const char *format, ...) 函数来从文件中读取字符串，但是在遇到第一个空格字符时，它会停止读取。
例如

#include <stdio.h>
int main()
{
   FILE *fp = NULL;
   char buff[255];
 
   fp = fopen("/tmp/test.txt", "r");
   fscanf(fp, "%s", buff);
   printf("1: %s\n", buff );
 
   fgets(buff, 255, (FILE*)fp);
   printf("2: %s\n", buff );
   
   fgets(buff, 255, (FILE*)fp);
   printf("3: %s\n", buff );
   fclose(fp);
 
}

test.txt中存的数据为
This is testing for fprintf…
This is testing for fputs…

产生下列结果：

1: This

2: is testing for fprintf...

3: This is testing for fputs...

因为首先，fscanf() 方法只读取了 This，因为它在后边遇到了一个空格。其次，调用 fgets() 读取剩余的部分，直到行尾。最后，调用 fgets() 完整地读取第二行。

C 库函数 size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream)从给定流 stream 读取数据到 ptr 所指向的数组中。

• ptr – 这是指向带有最小尺寸 size*nmemb 字节的内存块的指针。
• size – 这是要读取的每个元素的大小，以字节为单位。
• nmemb – 这是元素的个数，每个元素的大小为 size 字节。
• stream – 这是指向 FILE 对象的指针，该 FILE 对象指定了一个输入流。

成功读取的元素总数会以 size_t 对象返回，size_t 对象是一个整型数据类型。如果总数与 nmemb 参数不同，则可能发生了一个错误或者到达了文件末尾。

注: