【C语言】文件操作（超详细）

---

一、关于文件

1.1 为什么要写文件

如果没有文件，我们写的程序的数据是存储在电脑的内存中，如果程序退出，内存回收，数据就丢失了，等再次运行程序，是看不到上次程序的数据的，如果要将数据进行持久化的保存，我们可以使用文件。

1.2 什么是文件

磁盘(硬盘)上的文件是文件。
但是在程序设计中，我们一般谈的文件有两种:程序文件、数据文件(从文件功能的角度来分类的)。

• 程序文件：程序文件包括源程序文件(后缀为.c),目标文件(windows环境后缀为.obj),可执行程序(windows环境后缀为.exe)。
• 数据文件：文件的内容不一定是程序，而是程序运行时读写的数据，比如程序运行需要从中读取数据的文件，或者输出内容的文件。
  本章讨论的是数据文件
  在以前各章所处理数据的输入输出都是以终端为对象的，即从终端的键盘输入数据，运行结果显示到显示器上。
  其实有时候我们会把信息输出到磁盘上，当需要的时候再从磁盘上把数据读取到内存中使用，这里处理的就是磁盘上文件。

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

1.3 二进制文件和文本文件?

根据数据的组织形式，数据文件被称为文本文件或者二进制文件。

• 数据在内存中以二进制的形式存储，如果不加转换的输出到外存的文件中，就是二进制文件。
• 如果要求在外存上以ASCI码的形式存储，则需要在存储前转换。以ASCII字符的形式存储的文件就是文本文件。

一个数据在文件中是怎么存储的呢?

• 字符一律以ASCII形式存储，数值型数据既可以用ASCII形式存储，也可以使用二进制形式存储。

举个例子

#define _CRT_SECURE_NO_WARNINGS  1
#pragma warning(disable:6031)
#include<stdio.h>


int main()
{
	int a = 10000;
	FILE* pf = fopen("test.txt", "wb");
	fwrite(&a, 4, 1, pf);//以二进制的形式写到文件中
	fclose(pf);
	pf = NULL;
	return 0;
}

运行后，我们无法通过直接打开文件夹中的txt文件来获取有效信息

而是要通过VS打开二进制文件

通过右键点击源文件添加现有项后选择test.txt文件

再右键test.txt文件选择 打开方式 后选择二进制编译器

最后我们就可以发现我们再VS里打开了text.txt文件

至于这里存储的为什么是这样的8位数字我们可以看下图

因为笔者的编译器是X86环境且是小端存储，所以最后存储再text.txt的数值就是上述情况（大小端不理解的欢迎看笔者的另一篇文章 - 链接: link）

---

二、文件的打开和关闭

2.1 流和标准流

流

• 我们程序的数据需要输出到各种外部设备，也需要从外部设备获取数据，不同的外部设备的输入输出操作各不相同，为了方便程序员对各种设备进行方便的操作，我们抽象出了流的概念，我们可以把流想象成流淌着字符的河。
• C程序针对文件、画面、键盘等的数据输入输出操作都是通过流操作的。
• 一般情况下，我我们要想向流里写数据，或者从流中读取数据，都是要打开流，然后操作。

标准流
那为什么我们从键盘输入数据，向屏幕上输出数据，并没有打开流呢?那是因为C语言程序在启动的时候，默认打开了3个流:

• stdin-标准输入流，在大多数的环境中从键盘输入，scanf函数就是从标准输入流中读取数据。
• stdout-标准输出流，大多数的环境中输出至显示器界面，printf函数就是将信息输出到标准输出流中。
• stderr-标准错误流，大多数环境中输出到显示器界面。

这是默认打开了这三个流，我们使用scanf、printf等函数就可以直接进行输入输出操作的。
stdin、stdout、stderr 三个流的类型是: FILE*，通常称为文件指针。
C语言中，就是通过 FILE*的文件指针来维护流的各种操作的。

2.2 文件指针

缓冲文件系统中，关键的概念是 “文件类型指针”，简称 “文件指针”

每个被使用的文件都在内存中开辟了一个相应的文件信息区，用来存放文件的相关信息(如文件的名字，文件状态及文件当前的位置等)。这些信息是保存在一个结构体变量中的。该结构体类型是由系统声明的，取名 FILE.

例如，VS2013 编译环境提供的 stdio.h 头文件中有以下的文件类型申明

struct _iobuf {
    char* _ptr;
    int _cnt;
    char* _base;
    int _flag;
    int _file;
    int _charbuf;
    int _bufsiz;
    char* _tmpfname;
};
typedef struct _iobuf FILE;

不同的C编译器的FILE类型包含的内容不完全相同，但是大同小异。

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

一般都是通过一个FILE的指针来维护这个FILE结构的变量，这样使用起来更加方便。下面我们可以创建一个FILE*的指针变量:

FILE* pf; //⽂件指针变量

定义pf是一个指向FILE类型数据的指针变量。可以使pf指向某个文件的文件信息区(是一个结构体变量)。通过该文件信息区中的信息就能够访问该文件。也就是说，通过文件指针变量能够间接找到与它关联的文件。

2.3 文件的打开和关闭

文件在读写之前应该先打开文件，在使用结束之后应该关闭文件。
在编写程序的时候，在打开文件的同时，都会返回一个FILE*的指针变量指向该文件，也相当于建立了指针和文件的关系。
ANSIC规定使用 fopen 函数来打开文件，fclose 来关闭文件。

//打开⽂件
FILE * fopen ( const char * filename, const char * mode );

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

关于文件的打开关闭时的读写我们可以理解为下图，程序中的数据存储在内存中，从文件中读内容到程序，在程序中写内容到文件

mode表示文件的打开模式，下面都是文件的打开模式:

注意

• w 方法使用后，如果该文件已经存在并且有内容，会清空该文件内的内容后再打开写

实例代码

/* fopen fclose example */
#include <stdio.h>
int main () {
    FILE* pFile;
//打开⽂件
    pFile = fopen ("myfile.txt", "w");
//⽂件操作
    if (pFile != NULL) {
        fputs ("fopen example", pFile);
//关闭⽂件
        fclose (pFile);
    }
    return 0;
}

---

三、文件的顺序读写

3.1 顺序读写函数介绍

3.1.1 fputc （写单个字符）

int main()
{
	//1、打开文件
	FILE* pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}


	//2、写文件
	//int fputc ( int character, FILE * stream );
	fputc('a', pf); //字符型读入后转换为整形
	fputc('b', pf); 
	fputc('c', pf); 

	//3、关闭文件
	fclose(pf);
	pf = NULL;//置为空指针

	return 0;
}

在运行后没有报错的情况下打开text.txt，可以发现成功写入

倘若我们只把写文件部分改成下面串代码，会得到整个字母表

	//2、写文件
	//int fputc ( int character, FILE * stream );	
	//fputc('a', pf); 
	//fputc('b', pf); 
	//fputc('c', pf); 

	char ch = 0;
	for (ch = 'a'; ch <= 'z'; ch++)
	{
		fputc(ch, pf);//每次调用光标都会向后走一步
	}

3.1.2 fgetc（读取单个字符）

这里我们会发现它的返回类型时int，这是因为

• 如果成功读取字符的话，返回的是字符的ASCII码值 - char
• 如果读取遇到文件末尾，或者读取失败的时候，返回EOF（-1）

fgetc的读取原则时读取一个后，光标会向后移动一位

例如当前文件内容为字母表

代码块如下

int main()
{
	//打开文件
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}

	//读文件
	int ch = fgetc(pf);
	printf("%c\n", ch);

	ch = fgetc(pf);
	printf("%c\n", ch);

	ch = fgetc(pf);
	printf("%c\n", ch);

	ch = fgetc(pf);
	printf("%c\n", ch);

	//关闭文件
	fclose(pf);
	pf = NULL;

	return 0;
}

读取四个字符后输出结果如下

同fputc一样，fgetc也能够通过循环来读取所有的字符

读文件区域更改如下

//读文件
//int ch = fgetc(pf);
//printf("%c\n", ch);

//ch = fgetc(pf);
//printf("%c\n", ch);

//ch = fgetc(pf);
//printf("%c\n", ch);

//ch = fgetc(pf);
//printf("%c\n", ch);

int ch = 0;
while ((ch = fgetc(pf)) != EOF)//直至读到文件末尾
{
	printf("%c ", ch);
}

便得到了以下的结果

3.1.3 fputs（写入一整串字符）

我们写以下代码会得出下图结果

int main()
{
	//打开文件
	FILE* pf = fopen("test.txt", "w");//将原文件内容清空后写入
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}

	//写文件
	fputs("hello world", pf);


	//关闭文件
	fclose(pf);
	pf = NULL;
	return 0;
}

如果我们再次利用fputs输入一串字符串，并且不换行处理

	//写文件
	fputs("hello world", pf);
	fputs("hello bit", pf);

会发现这里的两处代码连在一起了，所以说，即使是fputs它的光标也是一次向后移动一位，为不会因为多输入一行而换行

3.1.4 fgets（读取一整串字符）

• 参数num需要特别注意下，假设我们需要读取10个字符，最终我们只会得到9个，而最后一个字符会产生一个\0

int main()//fgets
{
	//打开文件
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}

	//读文件
	char arr[20] = "xxxxxxxxxxxxxxxx";
	fgets(arr, 10, pf);
	



	//关闭文件
	fclose(pf);
	pf = NULL;

	return 0;
}

我们提前在文件里写入hello world

在程序进行完成后，我们可以发现哪怕原来后面还有字符，但是因为，num的最后一个必须是’\0’，所以它仍然会加上’\0’

但假如我们把文件里的内容改了，也就是第一行连9个字符都没有，然后继续读取fgets(arr, 10, pf);的话，我们会发现它在把第一行的’\n’读取后就直接输出’\0’了

所以fgets只能读取一行，如果字符数允许的话，能够把最后的’\n’也读取

但如果我们想要把每行都读取可以这样改

//读文件
//char arr[20] = "xxxxxxxxxxxxxxxx";
//fgets(arr, 10, pf);


char arr[20] = { 0 };
while (fgets(arr, 20, pf) != NULL)
{
	printf("%s", arr);
}

3.1.5 fprintf（格式化输出）

这个函数的用法跟printf很想，不过需要在格式化输入前附加文件名，以下为例

struct S
{
	char name[20];
	int age;
	float score;

};
int main()
{
	struct S s = { "张三",20,60.5f };

	FILE* pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("open");
		return 1;
	}
	//写文件 - 是以文本地形式写进去的
	fprintf(pf, "%s %d %f", s.name, s.age, s.score);

	fclose(pf);
	pf = NULL;


	return 0;
}

也是很成功地完成了文件地编写。

3.1.6 fscanf（格式化读取）

这里需要注意的是，它在读取时形参是地址，所以如果输入数不为地址或不是数组形式，需要在前面附加取地址符号以下为例

关于上面fprintf不用取地址，但是现在要取的说明：

结构体在输出时不需要取地址，是因为结构体变量本身就是一个地址，可以直接通过变量名来访问结构体的成员。而在读取结构体时需要取地址，是因为需要通过指针来操作结构体的成员。

struct S
{
	char name[20];
	int age;
	float score;

};
int main()
{
	struct S s = {0};

	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("open");
		return 1;
	}

	//读文件
	//这里name在结构体中是数组不用取地址，但是年龄和分数需要
	fscanf(pf, "%s %d %f", s.name, &(s.age), &(s.score));
	//打印
	printf("%s %d %f", s.name, s.age, s.score);


	fclose(pf);
	pf = NULL;


	return 0;
}

注意：
上述六个函数都适用于所有输入流，关于输入流的说法，大家可以简单认为有两种输入流，一种是文件，一种就是键盘和屏幕

举个例子

这里笔者没有用到任意文件但是仍用了fputs，只不过后面的目标从文件名变成了标准输出流stdout - 屏幕，所以就使得屏幕上写入了a这个字符

同理标准输入流 - stdin

---

补充（sscanf，sprintf)

以下举例

struct S
{
	char name[20];
	int age;
	float score;
};
int main()
{
	char buf[200] = { 0 };
	struct S s = { "张三",20,60.5f };
	sprintf(buf, "%s %d %f", s.name, s.age, s.score);

	printf("1、以字符串的形式：%s\n", buf);

	struct S t = { 0 };
	sscanf(buf, "%s %d %f", t.name, &(t.age), &(t.score));
	printf("2、按照格式打印：%s %d %f", t.name, t.age, t.score);

	return 0;
}

---

3.1.7 fwrite，fread（格式化输入、读取二进制文件）

我们可以看成fwrite是把数组里的元素写到流（文件里），
而fread就是从流（文件里）读取数据到数组，
剩下两个元素一个是每个元素的大小，一个是元素个数

以下举例

int main()
{
	int arr[] = { 1,2,3,4,5 };
	FILE* pf = fopen("test.txt", "wb");
	if (pf == NULL)
	{
		perror(fopen);
		return 1;
	}

	//写数据
	int sz = sizeof(arr) / sizeof(arr[0]);
	//以二进制的形式写入
	fwrite(arr, sizeof(arr[0]), sz, pf);

	fclose(pf);
	pf = NULL;





	int cur[5] = { 0 };
	FILE* pf1 = fopen("test.txt", "rb");
	if (pf1 == NULL)
	{
		perror(fopen);
		return 1;
	}

	fread(cur, sizeof(cur[0]), 5, pf1);
	for (int i = 0; i < 5; i++)
	{
		printf("%d ", arr[i]);
	}

	fclose(pf1);
	pf1 = NULL;

	return 0;
}

我们会发现它这里以二进制的形式存储到计算机里，我们看不懂，但是不影响fread的读取和输出

四、文件的随机读写

4.1 fseek

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

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

我们通过确定距离起始位置的偏移量来得出结果

以下举例

int main() {
    FILE* pFile;
    pFile = fopen("example.txt", "wb");
    fputs("This is an apple.", pFile);
    fseek(pFile, 9, SEEK_SET);
    fputs(" sam", pFile);
    fclose(pFile);
    return 0;
}

4.2 ftell

long int ftell ( FILE * stream )

作用是返回当前文件里光标的下标

#include <stdio.h>
int main() {
    FILE* pFile;
    long size;
    pFile = fopen("myfile.txt", "rb");
    if (pFile == NULL)
        perror("Error opening file");
    else {
        fseek(pFile, 0, SEEK_END); // non-portable
        size = ftell(pFile);
        fclose(pFile);
        printf("Size of myfile.txt: %ld bytes.\n", size);
    }
    return 0;
}

4.3 rewind

void rewind ( FILE * stream )

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

它没有返回任何值，而是直接定位到起始位置

#include <stdio.h>
int main()
{
	int n;
	FILE* pFile;
	char buffer[27];
	pFile = fopen("myfile.txt", "w+");
	for (n = 'A'; n <= 'Z'; n++)
		fputc(n, pFile);

	rewind(pFile);//这里将光标返回起始位置
	fread(buffer, 1, 26, pFile);
	fclose(pFile);
	buffer[26] = '\0';
	printf(buffer);
	return 0;
}

---

五、文件读取结束的判断

文件现在读取结束了，但是什么原因导致结束的还没知道，这里有两个函数可以用来判断

1. 有可能是遇上末尾了 - feof
2. 读取时发生了错误 - ferror

先补充一下知识

这是因为在我们打开一个流（文件）的时候，这个流上有两个标记值，一个是判断有没有遇到末尾，一个是是否发生错误

文本文件：文本文件是否结束，判断返回值是否为EOF（fgetc读取时），或者NULL（fgets读取时）

就拿fgets举例，如果读取正常，返回的是读取到的字符的ASCII码值
如果读取的过程中遇到文件末尾，或者发生错误，就返回EOF

二进制文件：判断方法是，判断返回值是否小于实际要读取的个数

重新回到函数feof

这里我们观察它的返回值，知道这个函数当遇到文件末尾就会返回一个非0的整数，相反，如果不是文件末尾就返回0

这里有两点需要特别注意，其一就是这个函数它有且仅有在遇到文件末尾时会返回一个非0常数，而其他时候不会，这意味着，我们没法直接通过这个函数判断一个流是否内置错误了，必须通过运行到文件末尾后，通过返回值的情况，判断流在运行过程中是否发生错误。

其二是feof函数只能在读取文件时判断文件是否已经结束，而不能在写文件时判断

以下为例

int main()
{
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}

	//读取
	int ch = 0;
	while ((ch = fgetc(pf)) != EOF)
	{
		printf("%c\n", ch);
	}

	//判断是什么原因导致读取结束的
	if (feof(pf))
	{
		printf("遇到文件末尾，读取正常结束\n");
	}

	return 0;
}

这里成功地读取完了所有字符，到达了末尾所以正常结束

再来看函数ferror

这个函数会判断这个流是否正确，如果错误，就会返回一个非0整数，否则返回0，与feof的用法很像

以下举例

int main()
{
	FILE* pf = fopen("test.txt", "r");//本该是w故意写成r
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}

	//写
	char ch;
	for (ch = 'a'; ch <= 'z'; ch++)
	{
		fputc(ch, pf);
	}


	//判断是什么原因导致结束的
	if (feof(pf))
	{
		printf("遇到文件末尾，读取正常结束\n");
	}
	else if (ferror(pf))
	{
		perror("fputc");
	}


	return 0;
}

我们可以发现这里因为本该是写入，我们确是以读取的方式进行的，所以最后输出的是这样的字符串

---

六、文件缓冲区

我们可以简单理解为下图

为了验证缓冲区地存在，我们可以写一段代码运行

#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;
}

这里我们通过睡眠来验证缓冲区的存在

10秒前即使程序已经运行，但这个文件里什么内容都没有

当10秒过后我们再次打开这个文件，里面的内容就出来了

---

小结

这篇文章主要从文件的本质和类型进行了说明，也介绍了8个用来文件读写的函数，3个针对文件光标位置的函数，以及2个判断文件结束情况的函数，基本上，每2个函数直接都是对应关系，有一定的规律，只要稍加记忆，便可很好掌握。