【C语言】文件操作

文件操作

1. 为什么要用文件

       我们用编程语言写一个通讯录时，肯定希望我们输入到通讯录中的数据持久保存（程序退出后再打开，数据依然存在），不必重新输入。
       这就涉及到了数据持久化的问题，我们一般数据持久化的方法有，把数据存放在磁盘文件、存放到数据库等方式。
       使用文件我们可以将数据直接存放在电脑的硬盘上，做到了数据的持久化。

2. 什么是文件

在程序设计中，我们一般谈的文件有两种：程序文件、数据文件（从文件功能的角度来
分类的）。

2.1 程序文件

包括源程序文件（后缀为.c）,目标文件（windows环境后缀为.obj）,可执行程序（windows环境后缀为.exe）。

2.2 数据文件

文件的内容不一定是程序，而是程序运行时读写的数据，比如程序运行需要从中读取数据的文件，或者输出内容的文件。

本篇讨论的就是数据文件。

2.3 文件名

一个文件要有一个唯一的文件标识（通常被称为文件名），以便用户识别和引用。
文件名包含3部分：文件路径+文件名主干+文件后缀。
例如： c:\code\test.txt。

3. 文件指针

文件类型指针，简称文件指针。
每个被使用的文件都在内存中开辟了一个相应的文件信息区用来存放文件的相关信息（如文件名、文件状态及文件当前位置等）。这些信息保存在一个结构变量中。该结构体类型是由系统声明，命名为FILE。


每当我们打开一个文件时，系统就会根据文件的情况自动创建一个FILE结构的变量，并填充其中的信息，作为使用者，我们不必关心其细节。

（在VS2019编译环境下，FILE结构体中的成员变量没有显示）
一般都是一个FILE的指针来维护这个FILE结构的变量，这样使用起来要方便得多。

FILE* pf;//文件指针变量
//pf是一个指向FILE类型数据的指针变量
//pf指向某个文件的文件信息区（一个结构体变量），可以通过该文件信息区的信息访问该文件

总之，通过文件指针变量可以找到与它关联的文件。

4. 文件的打开和关闭

文件在读写之前应该打开文件，使用结束之后应该关闭文件。
ANSI C（标准C）规定，使用函数fopen打开文件，fclose关闭文件。

//打开文件
FILE * fopen ( const char * filename, const char * mode );
//两个参数分别为文件名，打开方式

//关闭文件
int fclose ( FILE * stream );

在打开文件的同时，会返回一个FILE*的指针变量指向该文件。
若打开失败，则返回NULL。
文件打开方式如下：

文件使用方式	含义	如果指定文件不存在
“r”（只读）	为了输入数据，打开一个已经存在的文本文件	出错
“w”（只写）	为了输出数据，打开一个文本文件	建立一个新的文件
“a”（追加）	向文本文件尾添加数据	建立一个新的文件
“rb”（只读）	为了输入数据，打开一个二进制文件	出错
“wb”（只写） 为了输出数据，打开一个二进制文件 建立一个新的文件
“ab”（追加）	向一个二进制文件尾添加数据	出错
“r+”（读写）	为了读和写，打开一个文本文件	出错
“w+”（读写）	为了读和写，建议一个新的文件	建立一个新的文件
“a+”（读写）	打开一个文件，在文件尾进行读写	建立一个新的文件
“rb+”（读写）	为了读和写打开一个二进制文件	出错
“wb+”（读写）	为了读和写，新建一个新的二进制文件	建立一个新的文件
“ab+”（读写）	打开一个二进制文件，在文件尾进行读和写	建立一个新的文件

例如：

int main()
{
	//打开
	FILE* pf = fopen("text.txt", 'w');
	if (pf != NULL)
	{
		//...
	}
	//关闭
	fclose(pf);
	pf = NULL;
	return 0;
}

5. 文件的顺序读写

功能	函数名	适用于
字符输入函数	fgetc	所有输入流
字符输出函数	fputc	所有输出流
文本行输入函数	fgets	所有输入流
文本行输出函数	fputs	所有输出流
格式化输入函数	fscanf	所有输入流
格式化输出函数	fprintf	所有输出流
二进制输入	fread	文件
二进制输出	fwrite	文件

5.1 对比一组函数

scanf/fscanf/sscanf
printf/fprintf/sprintf

实例如下：

//fscanf/fprintf
struct S
{
	char name[20];
	int age;
};
void text1(struct S* s1)
{
	
	FILE* pf = fopen("text.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	fprintf(pf, "%s %d", s1->name,s1->age);

	fclose(pf);
	pf = NULL;
}
void text2(struct S* s2)
{
	FILE* pf2 = fopen("text.txt", "r");
	if (pf2 == NULL)
	{
		perror("fopen");
		return 1;
	}
	fread(pf2, "%s %d", s2->name,&(s2->age));

	fclose(pf2);
	pf2 = NULL;
}
int main()
{
	struct S s1 = { "zhangsan",20 };
	struct S s2 = { 0 };
	text1(&s1);
	text2(&s2);
	

	return 0;
}

//sscanf/sprintf
struct S
{
	char name[20];
	int age;
};
int main()
{
	struct S s = { "zhangsan",20 };
	struct S p = { 0 };
	char buf[50] = { 0 };
	sprintf(buf, "%s %d", s.name, s.age);

	sscanf(buf, "%s %d", p.name, &(p.age));
	return 0;
}

6. 文件的随机读写

6.1 fseek

根据文件指针的位置和偏移量来定位文件指针。

int fseek ( FILE * stream, long int offset, int origin );

例如：

int main()
{
	FILE* pf = fopen("text.txt", "wb");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	fputs("helloworld", pf);
	fseek(pf, 1, SEEK_SET);//定位到相对起始位置偏移量为2的位置//即定位到e
	fputs("wwww", pf);
	fclose(pf);
	pf = NULL;
	return 0;
}

若没有fseek,文件中的是：helloworld
若有fseek,文件中的是：hwwwwworld

5.2 ftell

返回文件指针相对于起始位置的偏移量。

long int ftell ( FILE * stream );

使用ftell可以计算当前文件指针相对于起始位置的偏移量。

6.3 rewind

让文件指针的位置回到起始位置。

void rewind ( FILE * stream );

7. 文本文件和二进制文件

根据数据的组织形式，数据文件被称为文本文件和二进制文件。
数据在内存中以二进制的形式存储，如果不加转换的输出到外存，就是二进制文件。
如果要求在外存上以ASCII码的形式存储，则需要在存储前转换。以ASCII码的形式存储的文件就是文本文件。

那么，一个数据在内存中是如何存储的呢？

字符均用ASCII码的形式存储，数值型数据既可以用ASCII码的形式存储，也可以用二进制的形式存储。
例如：要存储整数10000
若以ASCII的形式存储，需要5个字节（‘1’,‘0’,‘0’,‘0’,‘0’），若以二进制的形式存储，则需要4个字节。（下面是VS2019测试）

//测试代码
int main()
{
	int a = 10000;
	FILE* pf = fopen("text.txt", "wb");
	fwrite(&a, 4, 1, pf);
	fclose(pf);
	pf = NULL;
	return 0;
}

8. 文件读取结束的判定

注意：在文件读取过程中，不能用feof函数的返回值直接用来判断文件的是否结束。

而是应当在文件读取结束的时候，判断是读取失败结束，还是遇到文件尾结束。

1. 文本文件读取是否结束，判断返回值是否为EOF（fgetc），或者NULL （fgets）
   例如：
   1）fgets返回值是否为EOF
   2）fgets返回值是否为NULL
2. 二进制文件读取是否结束，判断返回值是否小于实际要读的个数
   例如：
   1）判断fread返回值是否小于实际要读的个数

正确写法
文本文件：

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
	int c; // 注意：int，非char，要求处理EOF
	FILE* fp = fopen("test.txt", "r");
	if (!fp) {
		perror("File opening failed");
		return EXIT_FAILURE;
	}
	//fgetc 当读取失败的时候或者遇到文件结束的时候，都会返回EOF
	while ((c = fgetc(fp)) != EOF) // 标准C I/O读取文件循环
	{
		putchar(c);
	}
	//判断是什么原因结束的
	if (ferror(fp))
		puts("I/O error when reading");
	else if (feof(fp))
		puts("End of file reached successfully");
	fclose(fp);
}

二进制文件：

#include <stdio.h>
enum { SIZE = 5 };
int main(void)
{
	double a[SIZE] = { 1.,2.,3.,4.,5. };
	FILE* fp = fopen("test.bin", "wb"); // 必须用二进制模式
	fwrite(a, sizeof * a, SIZE, fp); // 写 double 的数组
	fclose(fp);
	double b[SIZE];
	fp = fopen("test.bin", "rb");
	size_t ret_code = fread(b, sizeof * b, SIZE, fp); // 读 double 的数组
	if (ret_code == SIZE) {
		puts("Array read successfully, contents: ");
		for (int n = 0; n < SIZE; ++n) printf("%f ", b[n]);
		putchar('\n');
	}
	else { // error handling
		if (feof(fp))
			printf("Error reading test.bin: unexpected end of file\n");
		else if (ferror(fp)) {
			perror("Error reading test.bin");
		}
	}
	fclose(fp);
}

9. 文件缓冲区

ANSIC 标准采用“缓冲文件系统”处理的数据文件的，所谓缓冲文件系统是指系统自动地在内存中为程序中每一个正在使用的文件开辟一块“文件缓冲区”。从内存向磁盘输出数据会先送到内存中的缓冲区，装满缓冲区后才一起送到磁盘上。如果从磁盘向计算机读入数据，则从磁盘文件中读取数据输入到内存缓冲区（充满缓冲区），然后再从缓冲区逐个地将数据送到程序数据区（程序变量等）。缓冲区的大小根据C编译系统决定的。

代码测试：

#include <stdio.h>
#include <Windows.h>
int main()
{
	FILE* pf = fopen("test.txt", "w");
	fputs("abcdef", pf);//先将代码放在输出缓冲区
	printf("睡眠10秒-写入数据，打开test.txt文件，发现文件没有内容\n");
	Sleep(10000);
	printf("刷新缓冲区\n");
	fflush(pf);//刷新缓冲区时，才将输出缓冲区的数据写到文件（磁盘）
	//注：fflush 在高版本的VS上不能使用了
	printf("再睡眠10秒-此时，再次打开test.txt文件，文件有内容了\n");
	Sleep(10000);
	fclose(pf);
	//注：fclose在关闭文件的时候，也会刷新缓冲区
	pf = NULL;
	return 0;
}

结论：
因为有缓冲区的存在，C语言在操作文件的时候，需要做刷新缓冲区或者在文件操作结束的时候关闭文件。否则，可能导致读写文件出现问题。