文件操作详解（C语言）

一、为什么使用文件

在我们学习通讯录的时候，我们写的通讯录每次执行都是一次重新开始，重新写入数据，无法将上次输入的数据再次读取出来，我们在想既然是通讯录就应该把信息记录下来，只有我们自己选择删除数据的时候，数据才不复存在。这就涉及到了数据持久化的问题，我们一般数据持久化的方法有，把数据存放在磁盘文件、存放到数据库等方式。

使用文件我们可以将数据直接存放在电脑的硬盘上，做到了数据的持久化。

二、什么是文件

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

1.程序文件

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

2.数据文件

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

本文讨论的是数据文件。
在以前学习所处理数据的输入输出都是以终端为对象的，即从终端的键盘输入数据，运行结果显示到显示器上。
其实有时候我们会把信息输出到磁盘上，当需要的时候再从磁盘上把数据读取到内存中使用，这里处理的就是磁盘上文件。

3.文件名

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

三、文件的打开和关闭

理解：文件是在磁盘上，当我们要进行操作时（写入或读取），我们可以将文件当成终端，相当于键盘和屏幕，我们平时输入数据都是通过键盘进行写入，通过屏幕进行输出，如下图：

1.文件指针

缓冲文件系统中，关键的概念是“文件类型指针”，简称“文件指针”。
每个被使用的文件都在内存中开辟了一个相应的文件信息区，用来存放文件的相关信息（如文件的名字，文件状态及文件当前的位置等）。这些信息是保存在一个结构体变量中的。该结构体类型是有系统声明的，取名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.文件的打开和关闭

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

//打开文件
FILE * fopen ( const char * filename, const char * mode );
//关闭文件
int fclose ( FILE * stream );

打开方式如下：

例：

#include <stdio.h>
int main ()
{
	FILE * pFile;
	//打开文件
	pFile = fopen ("myfile.txt","w");  //如果当前文件所处目录无该文件，则创建一个该文件进行操作
	//文件操作
	if (pFile!=NULL)
	{
		fputs ("fopen example",pFile);
		//关闭文件
		fclose (pFile);
		pFile=NULL;     //置空，防止野指针
	}
	return 0;
}

四.文件的顺序读写

1. fgetc与fputc讲解

我们可以上网查找每个函数的具体用法，网址：https://legacy.cplusplus.com/
首先我们来看 fputc ：

我们可以看到该函数的第一个参数为输入的字符，第二个为文件指针。
成功后，将返回所写字符。如果发生写入错误，则返回 EOF 。
例：

#include<stdio.h>
int main()
{
	FILE* pf = fopen("WWT.text", "w");   //以写的方式打开该名称文件
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	fputc('a', pf);            //将字符a写入pf所指向的文件中
	fclose(pf);
	pf = NULL;
	return 0;
}

程序结束后，打开目录，如图，写入成功。
再来看fgetc：

fgetc是从文件指针指向的文件中读取字符，每次读取一个，返回字符读取（提升为 int 值）。
读取成功后，文件指针指向下一个字符，下次读取的就是下一个字符。
如果位置指示器位于文件末尾，则该函数返回 EOF ，如果发生其他读取错误，该函数也会返回 EOF。
我们先进行文件的写入，再读取：

#include<stdio.h>
int main()
{
	FILE* pf = fopen("WWT.text", "w"); //每次进行文件的写入都会清除上一次的写入数据
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	for (int i = 0; i < 26; i++)
	{
		fputc('a'+i, pf);   //输入26个字母
	}
	fclose(pf);
	pf = NULL;
	return 0;
}

程序运行结束后如图：

在进行读取前要将"w"改为"r"：

#include<stdio.h>
int main()
{
	FILE* pf = fopen("WWT.text", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//for (int i = 0; i < 26; i++)
	//{
	//	fputc('a'+i, pf);
	//}
	for (int i = 0; i < 26; i++)
	{
		printf("%c", fgetc(pf));   //在屏幕上打印26个字母
	}
	fclose(pf);
	pf = NULL;
	return 0;
}

2. fgets与fputs

先来看看函数使用规则：

第一个参数为字符串地址，后面是文件指针，成功后，将返回非负值。出错时，该函数返回 EOF。

从流中读取字符并将其作为 C 字符串存储到 str 中，直到读取 （num-1） 个字符或到达换行符或文件结尾，以先发生者为准。
换行符使 fgets 停止读取，但它被函数视为有效字符，并包含在复制到 str 的字符串中。
终止空字符会自动追加到复制到 str 的字符之后。
例：

int main()
{
	FILE* pf = fopen("WWT.text", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	fputs("abcd\n", pf);
	fputs(" abc\n", pf);
	fclose(pf);
	pf = NULL;
	return 0;
}

读取:

int main()
{
	FILE* pf = fopen("WWT.text", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//fputs("abcd\n", pf);
	//fputs(" abc\n", pf);
	char arr[20];
	fgets(arr, 8, pf);
	printf("%s", arr);
	fclose(pf);
	pf = NULL;
	return 0;
}

输出：abcd

3. fscanf与fprintf

函数原型：

int fprintf ( FILE * stream, const char * format, ... );

我们可以对比printf：

int printf ( const char * format, ... );

我们知道 printf 就是将数据通过给定形式打印到屏幕上，那 fprintf 就应该是将数据通过特定形式打印到文件中。
再来看fscanf：

int fscanf ( FILE * stream, const char * format, ... );

同样的对比scanf：

int scanf ( const char * format, ... );

scanf就是通过键盘将数据通过特定形式输入内存中去，那 fscanf 应该就是将文件的数据通过特定形式输出到内存中去。
例：

struct S
{
	char name[20];
	int age;
};
int main()
{
	FILE* pf = fopen("WWT.text", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	struct S s = { "zhangsan",29 };
	fprintf(pf, "%s %d", s.name, s.age);    //通过特定形式将特定数据写入pf所指向的文件中
	fclose(pf);
	pf = NULL;
	return 0;
}

读文件：

struct S
{
	char name[20];
	int age;
};
int main()
{
	FILE* pf = fopen("WWT.text", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//struct S s = { "zhangsan",29 };
	//fprintf(pf, "%s %d", s.name, s.age);
	struct S w;
	fscanf(pf, "%s %d", w.name, &(w.age));   //将pf中的数据通过特定形式拿出来，放到指定位置
	printf("%s %d", w.name, w.age);
	fclose(pf);
	pf = NULL;
	return 0;
}

输出：zhangsan 29

3.1 sscanf与sprintf

这两个函数其实也是输入输出函数，具体如何用呢？我们来看：

int sprintf ( char * str, const char * format, ... );

int fprintf ( FILE * stream, const char * format, ... );

通过对比我们发现它们的差异只在第一个参数，前者是字符串指针，后者是文件指针，由此我们可以得出，该函数是将数据通过计算写入字符串中，那sscanf 就是将字符串中的数据读出来。
由此，实例如下：

struct S
{
	char name[20];
	int age;
	float score;
};
int main()
{
	struct S s = { "zhangsan", 20, 95.5f };
	char arr[30] = { 0 };
	//将数据以特定形式写入字符串
	sprintf(arr, "%s %d %f", s.name, s.age, s.score);
	printf("%s\n", arr);
	struct S w = { 0 };
	//将arr中的数据以特定形式输出到特定变量中
	sscanf(arr, "%s %d %f", w.name, &(w.age), &(w.score));
	printf("%s %d %f\n", w.name, w.age, w.score);
	return 0;
}

输出：

3.2 fread与fwrite

size_t fwrite ( const void * ptr, size_t size, size_t count, FILE * stream );

ptr 是指向要写入的元素数组的指针，
size 是要写入的每个元素的大小，
count 是元素数，每个元素的大小为字节大小，
stream 是指向指定输出流的 FILE 对象的指针。

size_t fread ( void * ptr, size_t size, size_t count, FILE * stream );

ptr 是指向大小至少为（大小 * 计数）字节的内存块的指针，转换为 void *。
size 是要读取的每个元素的大小（以字节为单位）
count 是元素数，每个元素的大小为字节大小。
stream 是指向指定输入流的 FILE 对象的指针。
例：

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

int main()
{
	struct S s = { "zhangsan", 20, 95.5f };
	//把s中的数据写到文件中
	FILE*pf = fopen("test.txt", "wb");   //"wb"以二进制读写形式打开
	if (NULL == pf)
	{
		perror("fopen");
		return 1;
	}
	//二进制的写文件
	fwrite(&s, sizeof(s), 1, pf);  //将s里的数据通过计算写入pf中
	fclose(pf);
	pf = NULL;
	return 0;
}

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

int main()
{
	struct S s = { "zhangsan", 20, 95.5f };
	FILE* pf = fopen("test.txt", "rb");
	if (NULL == pf)
	{
		perror("fopen");
		return 1;
	}
	二进制的写文件
	//fwrite(&s, sizeof(s), 1, pf);
	//二进制的读文件
	struct S w;
	fread(&w, sizeof(w), 1, pf);  //将pf里的数据通过计算写入w中
	printf("%s %d %f", w.name, w.age, w.score);
	fclose(pf);
	pf = NULL;
	return 0;
}

输出：zhangsan 20 95.500000

五.文件的随机读写

1. fseek

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

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

第二个参数是指针的偏移量，根据指针初始位置来相对偏移
第三个参数是指针初始位置：
SEEK_SET 文件开头
SEEK_CUR 文件指针的当前位置
SEEK_END 文件结束

#include <stdio.h>
int main()
{
	FILE* pf = fopen("example.txt", "wb");
	if (NULL == pf)
	{
		perror("fopen");
		return 1;
	}
	fputs("This is an apple.", pf);
	fseek(pf, 9, SEEK_SET);  //文件开头开始偏移9个单位
	fputs(" sam", pf);     //偏移后指针指向字符n
	fclose(pf);
	pf = NULL;
	return 0;
}

2. ftell

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

long int ftell ( FILE * stream );

例（在上个程序文件存在下）：

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

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);   //将26字母写入字符串中
	buffer[26] = '\0';           //最后加上'\0'
	puts(buffer);             //打印出26字母
	fclose(pFile);
	pFile == NULL;
	return 0;
}

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

根据数据的输出形式，数据文件被称为文本文件或者二进制文件。
数据在内存中以二进制的形式存储，如果不加转换的输出到外存，就是二进制文件。
如果要求在外存上以ASCII码的形式存储，则需要在存储前转换。以ASCII字符的形式存储的文件就是文本文件。
一个数据在内存中是怎么存储的呢？
字符一律以ASCII形式存储，数值型数据既可以用ASCII形式存储，也可以使用二进制形式存储。
如有整数10000，如果以ASCII码的形式输出到磁盘，则磁盘中占用5个字节（每个字符一个字节），而二进制形式输出，则在磁盘上只占4个字节（VS2013测试）。

将10000转化为16进制显示出来就是：00000000 10270000 ，可以看出只占用4个字节。（注：转化为16进制是为了方便观察，实际是以二进制形式输出）
如果将10000以ASCII形式存储，那么就是将10000分为字符：‘1’ 、‘0’ 、‘0’ 、’ 0’ 、‘0’ 来存储，也就是分别存储这些字符对应的ASCII值。

例：

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

我们可以看到main函数以二进制形式编写“

七.文件读取结束的判定

1.被错误使用的 feof

牢记：在文件读取过程中，不能用feof函数的返回值直接用来判断文件的是否结束。
而是应用于当文件读取结束的时候，判断是读取失败结束，还是遇到文件尾结束。

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

文本文件的例子：

#include <stdio.h>
#include <stdlib.h>
int main()
{
	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);
	fp = NULL;
}

二进制文件的例子：

#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);
	fp = NULL;
}

输出：

8.文件缓冲区

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

#include <stdio.h>
#include <windows.h>
//VS2013 WIN10环境测试
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语言在操作文件的时候，需要做刷新缓冲区或者在文件操作结束的时候关闭文件。
如果不做，可能导致读写文件的问题。