文件相关操作

1. 为什么使用文件

我们前面学习结构体时，写了通讯录的程序，当通讯录运行起来的时候，可以给通讯录中增加、删除数据，此时数据是存放在内存中，当程序退出的时候，通讯录中的数据自然就不存在了，等下次运行通讯录程序的时候，数据又得重新录入，如果使用这样的通讯录就很难受。

我们在想既然是通讯录就应该把信息记录下来，只有我们自己选择删除数据的时候，数据才不复存在。这就涉及到了数据持久化的问题，我们一般数据持久化的方法有，把数据存放在磁盘文件、存放到数据库等方式。

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

2. 什么是文件

磁盘上的文件是文件。

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

2.1 程序文件

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

2.2 数据文件

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

本章讨论的是数据文件。
在以前各章所处理数据的输入输出都是以终端为对象的，即从终端的键盘输入数据，运行结果显示到显示器上。

其实有时候我们会把信息输出到磁盘上，当需要的时候再从磁盘上把数据读取到内存中使用，这里处理的就是磁盘上文件。

2.3 文件名

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

为了方便起见，文件标识常被称为文件名。

3. 文件的打开和关闭

3.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;  //该结构体被重命名为FILE

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

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

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

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

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

3.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("FileTest.txt", "w");
	//文件操作
	if (pFile != NULL)
	{
		fputs("fopen example", pFile);
		//关闭文件
		fclose(pFile);
	}
	return 0;
}

我以读的形式打开，它在我这个文件路径下会生成一个txt文件，再将“fopen example”写进去。

4. 文件的顺序读写

4.1 fgetc 和 fputc：

fgetc：从文件中读取一个字符到内存中；
fputc：从内存中输出一个字符到文件中。

• stream
  
  指向标识输入流的 FILE 对象的指针(对应的文件指针)。

• stream
  
  指向标识输出流的 FILE 对象的指针(对应的文件指针)。
• character

待入写字符的int型(待写入的字符)。
写入时，该值在内部转换为无符号字符。

使用：

#include <stdio.h>
int main()
{	
		FILE* pf = fopen("test.txt", "w");//打开文件
		if (pf == NULL)
		{
			perror("fopen");
			return 1;
		}
		//向文件中写入字符
		fputc('a', pf);
		fputc('b', pf);
		fputc('c', pf);
		fputc('d', pf);
		fclose(pf);//关闭文件
		pf = NULL;
	return 0;
}

#include <stdio.h>
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;
}

• 我们每次调用文件顺序读写的相关函数之后，管理该文件的文件指针都会自动向后偏移一位。

4.2 fgets 和 fputs

fgets：从文件中读取一行字符到内存中；
fputs：从内存中输出一行字符到文件中。

• str
  要输出内容的字符串。
• stream
  对应的文件指针。

• str
  指向要复制读取的字符串的字符数组的指针。
• num
  要复制到 str 中的最大字符数(包括终止空字符)。
• stream
  对应的文件指针。

使用：

int main()
{
	//打开文件
	FILE* pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//向文件中写入一行字符
	fputs("hello", pf);
	fputs("world", pf);

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

int main()
{
	//打开文件
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//从文件中读取字符
	char arr[20];
	fgets(arr, 6, pf);
	printf("%s\n", arr);
	fgets(arr, 6, pf);
	printf("%s\n", arr);

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

4.3 fscanf 和 fprintf

fscanf：把文件中的数据格式化的读取到内存中；
fprintf：把内存中的数据格式化的写入到文件中；

• stream
  对应的文件指针。
• fromat
  格式控制字符串。

• stream
  对应的文件指针。
• format
  格式控制字符串。

使用：

struct Stu
{
	char name[20];
	int age;
	char sex[10];
};

int main()
{
	struct Stu stu = { "zhangsan", 20, "nan" };
	//打开文件
	FILE* pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//向文件中格式化写入数据
	fprintf(pf, "%s %d %s", stu.name, stu.age, stu.sex);

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

struct Stu
{
	char name[20];
	int age;
	char sex[10];
};

int main()
{
	struct Stu stu = { "zhangsan", 20, "nan" };
	//打开文件
	FILE* pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//向文件中格式化写入数据
	fprintf(pf, "%s %d %s", stu.name, stu.age, stu.sex);
	printf("%s %d %s\n", stu.name, stu.age, stu.sex);
	//关闭文件
	fclose(pf);
	pf = NULL;
	return 0;
}

4.4 fwrite 和 fread

fwrite：以二进制的形式向文件中写入数据；
fread：以二进制的形式从文件中读取数据；

• ptr
  指向要写入的元素数组的指针，转换为 const void*
  (指向要写入的空间的起始地址)。
• size
  要写入的每个元素的大小。
• count
  要写入元素的数量，每个元素的大小为 size 字节。
• stream
  对应文件指针。
  

• ptr
  指向一块大小至少是sizecount的内存的指针，并转换为void。
• size
  要读的每个元素的大小。
• count
  要读元素的数量，每个元素的大小为 size 字节。
• stream
  对应的文件指针。

使用：

struct Stu
{
	char name[20];
	int age;
	char sex[10];
};

int main()
{
	struct Stu stu = { "zhangsan", 20, "nan" };
	//打开文件
	FILE* pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//以二进制的形式向文件中格式化写入数据
	fwrite(&stu, sizeof(struct Stu), 1, pf);

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

struct Stu
{
	char name[20];
	int age;
	char sex[10];
};

int main()
{
	struct Stu stu = { 0 };
	//打开文件
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//以二进制的形式从文件中格式化读取数据
	fread(&stu, sizeof(struct Stu), 1, pf);
	printf("%s %d %s\n", stu.name, stu.age, stu.sex);

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

• 在使用fwrite时出现了**‘烫’的字样，因为它是二进制**，我们看不懂是正常的。

sscanf 与 sprintf

sscanf：将一个字符串中的数据格式化；
sprintf：将一组格式化的数据转换为字符串；

• s

• format
  格式控制字符串。

• argumeng
  可选参数。

• str
  用于存储数据的字符串的首地址(空间必须足够大)。
• format
  格式控制字符串。
• argumeng
  可选参数。

使用：

struct Stu
{
	char name[20];
	int age;
	char sex[10];
};

int main()
{
	struct Stu stu = { "zhangsan", 20, "nan" };
	char str[50];  //定义一个字符数组，用来存储从结构体中读取的数据
	//将一组格式化的数据转换为字符串
	sprintf(str, "%s %d %s", stu.name, stu.age, stu.sex);
	printf("%s\n", str);
	//将一个字符串中的数据格式化
	struct Stu stu1 = { 0 };
	sscanf(str, "%s %d %s", stu1.name, &(stu1.age), stu1.sex);
	printf("%s %d %s\n", stu1.name, stu1.age, stu1.sex);
	return 0;
}

5. 文件的随机读写

5.1 fseek

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

• stream
  对应的文件指针
• offset
  二进制文件：要从源偏移的字节数。
  文本文件：零或 ftell 返回的值。
  （相对于origin参数的偏移量）。
• origin
  偏移量的参考位置。
  

---

设置成功返回0，不成功返回非0。

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

#include <stdio.h>
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;
}

5.2 ftell

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

• stream
  对应文件的指针。

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

5.3 rewind

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

void rewind ( FILE * stream );

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';
	puts (buffer);
	return 0;
}

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

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

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

一个数据在内存中是怎么存储的呢？

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

如有整数10000，如果以ASCII码的形式输出到磁盘，则磁盘中占用5个字节（每个字符一个字节），而二进制形式输出，则在磁盘上只占4个字节

如图：

7. 文件读取结束的判定

被错误使用的feof

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

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

• fgetc 判断是否为 EOF .
• fgets 判断返回值是否为 NULL

2. 二进制文件的读取结束判断，判断返回值是否小于实际要读的个数。

• fread判断返回值是否小于实际要读的个数。

feof 函数的正确使用:
文本文件：

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

8. 文件缓冲区

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语言在操作文件的时候，需要做刷新缓冲区或者在文件操作结束的时候关闭文件。
如果不做，可能导致读写文件的问题。