C语言文件操作

1. 为什么使用文件

我们在平时写代码时，我们代码中的所有变量都会被编译器预先放到栈内存区，堆内存区，静态内存区，常量内存区，但当我们关闭此应用程序那么这些开辟的内存也将还给操作系统。如果我们想把部分或者全部内容记录下来时，这就涉及到了数据持久化的问题，一般数据持久化的方法有：把数据存放在磁盘文件，存放到数据库等。
使用文件我们可以直接将数据存放在电脑的硬盘上，做到了数据持久化。

2. 什么是文件

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

2.1 程序文件

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

2.2 数据文件

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

本章讨论的是数据文件。

在以前各章所处理数据的输入输出都是以终端为对象的，即从终端的键盘输入数据，运行结果显示到显
示器上
scanf---------------在从键盘得到数据（读操作）
printf---------------把数据输出到屏幕上（写操作）

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

2.3 文件名

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

不同的C编译器的FILE类型包含的内容不完全相同，但是大同小异。
每当打开一个文件的时候，系统会根据文件的情况自动创建一个FILE结构的变量，并填充其中的信息，
使用者不必关心细节。
一般都是通过一个FILE的指针来维护这个FILE结构的变量，这样使用起来更加方便。

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

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

3.2 文件的打开和关闭

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

打开方式如下：

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

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

int main()
{
	//打开文件
	FILE*pf = fopen("test.txt", "w");如果不写文件路径则表明文件在默认的项目路径下创建txt（相对路径）
	//FILE* pf = fopen("c:\\code\\test.txt", "w");//（绝对路径）需要注意转义字符
	if (NULL == pf)
	{
		perror("fopen");
		return 1;
	}

	//写文件


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

4. 文件的顺序读写

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

4.1 fgetc,fputc(后续都只提取函数部分的介绍)

这里情调一下fgetc的返回值

成功后:将返回读取的字符（提升为int值）。
失败：如果位置指示器位于文件末尾，则函数返回EOF并设置流的EOF指示器（feof）。如果发生其他读取错误，函数也会返回EOF，但会设置其错误指示符（feror）。

int main()
{
	//在文件test.txt中存放"abcd"这个字符串
	//打开文件
	//char arr[] = "abcd";
	//FILE* fps = fopen("test.txt", "w");
	//if (fps == NULL)
	//{
	//	ferror("fopen:");
	//	return 1;
	//}
	写操作
	//int sz = sizeof(arr) / sizeof(arr[0]);
	//int i = 0;
	//for (i = 0 ; i < sz; i++)
	//{
	//	fputc(arr[i], fps);
	//}
	关闭文件
	//fclose(fps);
	//fps = NULL;

	//从test.txt读取"abcd"这个字符串
	//打开文件
	FILE* fps = fopen("test.txt", "r");
	if (fps == NULL)
	{
		ferror("fopen:");
		return 1;
	}
	//读操作
	char brr[20];
	int i = 0;
	do
	{
		brr[i] = fgetc(fps);
		i++;
	} while (brr[i-1] != EOF);// 这里为了强调fgetc()的返回值，其实更确切的判断应该为while(brr[i-1]!='\0')
	printf("%s", brr);
	//关闭文件
	fclose(fps);
	fps = NULL;
	return 0;
}

4.2 fgets,fputs

函数从指定的地址（str）开始复制，直到到达终止的空字符（“\0”）。此终止空字符不会复制到流。

返回值
成功时，返回非负值。出错时，函数返回EOF并设置错误指示符（feror）。

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

返回值
如果读取正常，返回的是存放读取到的数据的地址
如果读取失败，返回的NULL

int main()
{
	//打开文件
	FILE* fps = fopen("test.txt","w");
	if (fps == NULL)
	{
		ferror("fopen:");
		return 1;
	}
	//写操作
	char arr[] = "abcdef\n";
	char brr[] = "ghijk\n";
	fputs(arr, fps);
	fputs(brr, fps);
	//关闭文件
	fclose(fps);
	fps = NULL;


	//打开文件
	/*FILE**/ fps = fopen("test.txt", "r");
	if (fps == NULL)
	{
		ferror("fopen:");
		return 1;
	}
	//读操作
	char crr[20] = "****************";
	printf("%s", fgets(crr, 20, fps));
	fgets(crr, 20, fps);
	printf("%s", crr);
	//关闭文件
	fclose(fps);
	fps = NULL;
	return 0;
}

4.3fscanf,fprintf

fscanf,fprintf只需要在scanf和printf的函数参数开始加个文件指针（文件流）

从流中读取数据，并根据参数格式将其存储到附加参数指定的位置
附加参数应指向已分配的对象，该对象的类型由格式字符串中相应的格式说明符指定。

返回值
成功时，函数返回参数列表中成功填充的项数。由于匹配失败、读取错误或到达文件末尾，此计数可能与预期的项数匹配，也可能小于（甚至为零）。
如果在读取时发生读取错误或到达文件末尾，则设置适当的指示符（feof或feror）。并且，如果在成功读取任何数据之前发生任何一种情况，则返回EOF。

将按格式指向的C字符串写入流。如果格式包含格式说明符（以%开头的子序列），则格式化格式后的附加参数并将其插入结果字符串中，以替换其各自的说明符。

返回值
成功后，返回写入的字符总数。
如果发生写入错误，则设置错误指示器（ferror）并返回负数。

typedef struct student
{
	char name[20];
	int age;
	float score;
}STU;
int main()
{
	STU s = { "张三",15,80.1 };
	FILE* fps = fopen("test.txt", "w");
	if (fps == NULL)
	{
		ferror("fopen:");
		return 1;
	}
	fprintf(fps, "%s %d %f", s.name, s.age, s.score);
	fclose(fps);
	fps = NULL;


	STU j = { 0 };
	/*FILE**/ fps = fopen("test.txt", "w");
	if (fps == NULL)
	{
		ferror("fopen:");
		return 1;
	}
	fscanf(fps, "%s %d %f", s.name, &s.age, &s.score);
	printf( "%s %d %f", s.name, s.age, s.score);

	fclose(fps);
	fps = NULL;
	return 0;
	return 0;
}

4.4 fwrite,fread

从流中读取count个元素，每个元素的大小为size，并将其存储在ptr指定的内存块中。流的位置指示器提前读取的字节总数。如果成功，则读取的字节总数为（大小*计数）。

返回值
返回成功读取的元素总数。如果此数字与count参数不同，则可能发生读取错误或读取时到达文件末尾。在这两种情况下，都设置了适当的指示器，可以分别用feror和feof进行检查。如果大小或计数为零，则函数返回零，并且流状态和ptr指向的内容保持不变。size_t是无符号整数类型。

从ptr指向的内存块向流中的当前位置写入count个元素，每个元素的大小为size的数据。

返回值
返回成功写入的元素总数。
如果此数字与count参数不同，则写入错误会阻止函数完成。在这种情况下，将为流设置错误指示符（feror）。如果大小或计数为零，则函数返回零，错误指示符保持不变。size_t是无符号整数类型。

/二进制的形式：写一个结构体的数据
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");
	if (NULL == pf)
	{
		perror("fopen");
		return 1;
	}
	//二进制的写文件
	fwrite(&s, sizeof(s), 1, pf);

	fclose(pf);
	pf = NULL;
	return 0;
}


二进制的读文件
struct S
{
	char name[20];
	int age;
	float score;
};

int main()
{
	struct S s = {0};
	//把s中的数据写到文件中
	FILE* pf = fopen("test.txt", "rb");
	if (NULL == pf)
	{
		perror("fopen");
		return 1;
	}
	//二进制的读文件
	fread(&s, sizeof(s), 1, pf);

	printf("%s %d %f\n", s.name, s.age, s.score);

	fclose(pf);
	pf = NULL;
	return 0;
}

4.5 对比一组函数：

scanf/fscanf/sscanf
printf/fprintf/sprintf

scanf/fscanf与printf/fprintf
scanf，printf适用于标准输入输出流
fscanf,fprintf适用于所有输入输出流，对此我们只要将流改为标准输入输出流就可以把fscanf，fprintf当成scanf，printf
同理对于上述提到的fgetc、fputc、fgets、fputs

对于任何一个C程序，只要运行起来
就默认打开3个流
stdin - 标准输入流 - 键盘
stdout - 标准输出流 - 屏幕
stderr - 标准错误刘 - 屏幕

sscanf，sprintf(类似scanf、printf，但对像不是标准输入输出流，而是字符指针(指针指向位于缓存区的一块内存)）

sscanf:从字符指针指向的内存读取数据并根据参数格式将其存储到附加参数指定的位置，就像使用了scanf一样，但从s而不是标准输入（stdin）读取数据

sprintf：使用与printf上使用的格式相同的文本组成一个字符串，但内容不是打印的，而是以字符串的形式存储在缓冲区中。缓冲区的大小应该足够大，以包含整个结果字符串）
sscanf--------可以将字符串的数据转化成格式化的数据存储
sprintf--------可以将格式化的数据转化成字符串的形式存储

struct S
{
	char name[10];
	int age;
	float score;
};
int main()
{
	char buf[100] = {0};
	struct S tmp = { 0 };

	struct S s = { "zhangsan", 20, 95.5f };
	//能够把这个结构体的数据，转换成字符串
	//"zhangsan 20 95.5"
	sprintf(buf, "%s %d %f", s.name, s.age, s.score);//以字符串的形式打印
	printf("%s\n", buf);

	//能否将buf中的字符串，还原成一个结构体数据呢？
	sscanf(buf, "%s %d %f", tmp.name, &(tmp.age), &(tmp.score));
	printf("%s %d %f\n", tmp.name, tmp.age, tmp.score);//以结构的形式打印

	return 0;
}

5. 文件的随机读写

5.1 fseek

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

steam：正在操作的文件指针
offser：偏移的字节数
origin：用作偏移参考的位置

origin的几个偏移参考位置

例子：

5.2 ftell

long int ftell ( FILE * stream );

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

int main()
{
	//test.txt中存放abcde
	FILE* fps = fopen("test.txt", "r");
	if (fps == NULL)
	{
		ferror("fopen");
		return 1;
	}
	printf("%c\n", fgetc(fps));//读取a文件指针指向b
	fseek(fps, 2, SEEK_CUR);//从当前指针跳过2个字节指向d
	printf("%c\n", fgetc(fps));//读取d后指针指向e
	printf("%d\n", ftell(fps));//偏移起始位置4个字节
	return 0;
}

5.3 rewind

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

void rewind ( FILE * stream );

/* rewind example */
#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';
	puts (buffer);
	return 0;
}

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

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

7. 文件读取结束的判定

7.1 被错误使用的feof

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

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

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

2. 二进制文件的读取结束判断，判断返回值是否小于实际要读的个数。
   例如：
   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);
}

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