C语言（文件操作）

为什么使用文件

我们前面学习结构体时，写了通讯录的程序，当通讯录运行起来的时候，可以给通讯录中增加、删除数据，此时数据是存放在内存中，当程序退出的时候，通讯录中的数据自然就不存在了，等下次运行通讯录程序的时候，数据又得重新录入，如果使用这样的通讯录就很难受。
我们在想既然是通讯录就应该把信息记录下来，只有我们自己选择删除数据的时候，数据才不复存在。这就涉及到了数据持久化的问题，我们一般数据持久化的方法有，把数据存放在磁盘文件、存放到数据库等方式。
使用文件我们可以将数据直接存放在电脑的硬盘上，做到了数据的持久化。

一、什么是文件

磁盘上的文件是文件。

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

1.1 程序文件

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

1.2 数据文件

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

写文件和读文件

由上图可知：

写文件：通过test.c程序文件向data.txt数据文件写入数据

读文件：通过test.c程序文件从data.txt数据文件读取数据

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

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

输出和输入

输出：把内存中的数据显示到显示器上，或写入文件中，都属于输出

输入：文件中的数据读取到内存中，或从终端的键盘中输入数据，放到内存中，都属于输入

1.3 文件名

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

二、文件的打开和关闭

2.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* pf;//文件指针变量

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

下面我们可以创建一个FILE*的指针变量:

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

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

2.2 文件的打开和关闭

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

#include<stdio.h>
#include<string.h>
#include<errno.h>
int main()
{
    //打开文件
   FILE*pf=fopen("test.text","w");
   if(pf==NULL)
   {
       printf("%s\n",strerror(errno));
       return 0;
   }
    //写文件
    //关闭文件
    fclose(pf);
    pf=NULL;
    return 0;
}

打开方式如下：

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

三、文件的顺序读写

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

补充：

所有输入输出流包括标准流和文件流

所以fputc、fputs、fprintf函数的stream参数可以使用stdout打印到屏幕上。

3.1 字符输出函数

一次写入一个字符：

int fputc ( int character, FILE * stream );//返回值:若写入成功，返回字符ASCⅡ码，若写入失败，返回EOF

character	写入的字符整型提升，当写入文件时，再转换unsigned char
stream		指向流的指针

举例：

#include<stdio.h>
#include<string.h>
#include<errno.h>
int main()
{
    //打开文件
   FILE*pf=fopen("test.txt","w");
   if(pf==NULL)
   {
       printf("%s\n",strerror(errno));
       return 0;
   }
    //写文件
    char ch=0;
    for(ch='a';ch<='z';ch++)
    {
        fputc(ch,pf);
    }
    //关闭文件
    fclose(pf);
    pf=NULL;
    return 0;
}

3.2 文本行输出函数

一次写入一行：

int fputs ( const char * str, FILE * stream );//返回值:若写入成功，返回一个非负值，若写入失败，返回EOF

str		写入流的字符串
stream  指向流的指针

举例：

#include<stdio.h>
#include<string.h>
#include<errno.h>
int main()
{
    //打开文件
   FILE*pf=fopen("test.txt","w");
   if(pf==NULL)
   {
       printf("%s\n",strerror(errno));
       return 0;
   }
    //写文件
    fputs("hello world\n",pf);
    fputs("hehe\n",pf);
    //关闭文件
    fclose(pf);
    pf=NULL;
    return 0;
}

3.3 字符输入函数

读一个：

int fgetc ( FILE * stream );//返回值:若读取成功，返回字符ASCⅡ码，若文件结束或读取失败，返回EOF

#include<stdio.h>
#include<string.h>
#include<errno.h>
int main()
{
    //打开文件
   FILE*pf=fopen("test.txt","r");
   if(pf==NULL)
   {
       printf("%s\n",strerror(errno));
       return 0;
   }
    //读文件
    int ch=0;
    while((ch=fgetc(pf))!=EOF)//当读取完第一个字符后，文件指针指向下一个字符
    {
        printf("%c\n",ch);
    }
    //关闭文件
    fclose(pf);
    pf=NULL;
    return 0;
}

3.4 文本行输入函数

读一行：

char * fgets ( char * str, int num, FILE * stream );//返回值:如果读取成功，返回str,如果文件结束或读取失败，返回NULL

str		一个字符指针，指向字符数组的首元素，字符数组的内容是从stream复制过来
num		被复制到字符数组的最大字符个数
stream  指向流的指针

举例：

#include<stdio.h>
#include<string.h>
#include<errno.h>
int main()
{
    //打开文件
   FILE*pf=fopen("test.txt","r");
   if(pf==NULL)
   {
       printf("%s\n",strerror(errno));
       return 0;
   }
    char buf[1000]={0};
    //读文件
    fgets(buf,1000,pf);
    printf("%s",buf);
    //关闭文件
    fclose(pf);
    pf=NULL;
    return 0;
}

3.5 格式化输入函数

写入结构体(格式化输入)

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

举例：

struct Stu
{
    char name[20];
    int age;
    double d;
};

int main()
{
    struct Stu s = { "张三",20,95.5 };
    FILE* pf = fopen("data.txt", "w");
    if (pf == NULL)
    {
        printf("%s\n", strerror(errno));
        return 0;
    }
    fprintf(pf, "%s %d %lf", s.name, s.age, s.d);

    fclose(pf);
    pf = NULL;

    return 0;
}

3.6 格式化输出函数

读取格式化数据

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

举例：

struct Stu
{
    char name[20];
    int age;
    double d;
};

int main()
{
    struct Stu s={0};
    FILE*pf=fopen("data.txt","r");
    if(pf==NULL)
    {
        printf("%s\n",strerror(errno));
        return 0;
    }
    fscanf(pf,"%s %d %lf",s.name,&s.age,&s.d);
    printf("%s %d %lf",s.name,s.age,s.d);
    fclose(pf);
    pf=NULL;
    
    return 0;
}

3.7 二进制输出

写入二进制文件

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

ptr		指向要写入的元素数组的指针，转换为const void*类型
size	每个元素的字节大小
count	写入文件的元素个数
stream	指向文件流的指针

举例：

struct Stu
{
    char name[20];
    int age;
    double d;
};
int main()
{
    struct Stu s = { "张三",20,95.5 };
    //打开文件（"wb"打开二进制文件）
    FILE* pf = fopen("data.txt", "wb");
    if (pf == NULL)
    {
        printf("%s\n", strerror(errno));
        return 0;
    }
    //按照二进制的方式写入文件
    fwrite(&s, sizeof(struct Stu), 1, pf);

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

3.8 二进制输入

二进制读取文件

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

ptr		指向内存块的指针，该内存块的大小至少为(size*count)字节，转换为void*类型
size	每个元素的字节大小
count	读取元素的个数
stream	指向文件流的指针

举例：

struct Stu
{
    char name[20];
    int age;
    double d;
};
int main()
{
    struct Stu s = { 0 };
        //打开文件
    FILE * pf = fopen("data.txt", "rb");
    if (pf == NULL)
    {
        printf("%s\n", strerror(errno));
        return 0;
    }
    //按照二进制的方式读取文件
    fread(&s, sizeof(struct Stu), 1, pf);
    printf("%s %d %lf", s.name, s.age, s.d);
    //关闭文件
    fclose(pf);
    pf = NULL;
    return 0;
}

3.9 补充

3.9.1 标准流

问：

我们再将数据写入文件中，需要打开文件，数据写入后，需要关闭文件，为什么将内存的数据输出到屏幕时，没有类似的操作？

答：

C语言程序，只要运行起来，就默认打开三个流：

stdin 标准输入流（键盘输入）

stdout 标准输出流（打印到屏幕）

stderr 标准错误流

以上三个流都为FILE*类型

for(ch='a';ch<='z';ch++)
{
    fputc(ch,stdout);//打印到屏幕上（因为fputc使用于所有流，可以使用stdout）
}

3.9.2 实现拷贝文件

实现一个代码将data.txt拷贝一份生成data2.txt

#include<stdio.h>
#include<string.h>
#include<errno.h>
int main()
{
    FILE*pf=fopen("data.txt","r");
    if(pf==NULL)
    {
        printf("%s\n",strerror(errno.h));
        return 0;
    }
    FILE*pr=fopen("data2.txt","w");
    if(pr==NULL)
    {
        printf("%s\n",strerror(errno.h));
        fclose(pf);
        pf=NULL;
        return 0;
    }
    //拷贝文件
    int ch=0;
    while((ch=fgetc(pf))!=EOF)
    {
        fputc(ch,pw);
    }
    //关闭文件
    fclose(pf);
    pf=NULL;
    fclose(pr);
    pr=NULL;
    
    return 0;
}

3.9.3 对比一组函数

scanf/fscanf/sscanf

printf/fprintf/sprintf

一、

scanf		从标准输入流（stdin）上进行格式化输入函数
printf		从标准输出流（stdout）上进行格式化输出函数

二、

fscanf		可以从标准输入流（stdin）/指定的文件流 上读取格式化的数据
fprintf		把数据按照格式化的方式输出到标准输出流（stdout）/指定文件流

举例见本博客格式化输入输出函数

三、

sscanf		可以从一个字符串中转换出格式化数据
sprintf		把一个格式化数据转换成字符串

举例：

int sscanf ( const char * s, const char * format, ...);

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

struct Stu
{
	char name[20];
	int age;
	double d;
};
int main()
{
	struct Stu s = { "张三", 20, 95.5 };
	struct Stu tmp = { 0 };

	char  buf[100] = { 0 };
	sprintf(buf, "%s %d %lf", s.name, s.age, s.d);//
	printf("%s\n", buf);

	sscanf(buf, "%s %d %lf", tmp.name, &(tmp.age), &(tmp.d));
	printf("%s %d %lf\n", tmp.name, tmp.age, tmp.d);

	return 0;
}

输出：

四、文件的随机读写

4.1 fseek

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

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

stream 流

offset 偏移量

origin 起始位置

​ SEEK_SET 文件的开始位置

​ SEEK_CUR 文件指针当前指向的位置

​ SEEK_END 文件的结尾位置

返回值（int）成功返回0，失败返回非0

int main()
{
	FILE* pf = fopen("test.txt", "r");//文件中"hello world"
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	int ch;
	ch = fgetc(pf);
	printf("%c\n", ch);
	ch = fgetc(pf);
	printf("%c\n", ch);

	fseek(pf, 2, SEEK_CUR);//当前文件指针指向第一个l，偏移两个是o
	ch = fgetc(pf);
	printf("%c\n", ch);
	ch = fgetc(pf);//打印o

	pf = NULL;
	return 0;
}

4.2 ftell

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

int main()
{
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	int ch;
	ch = fgetc(pf);
	printf("%c\n", ch);
	ch = fgetc(pf);
	printf("%c\n", ch);

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

	int ret = ftell(pf);//打印5
	printf("%d\n", ret);
	fclose(pf);
	pf = NULL;
	return 0;
}

4.3 rewind

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

int main()
{
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	int ch;
	ch = fgetc(pf);
	printf("%c\n", ch);
	ch = fgetc(pf);
	printf("%c\n", ch);

	fseek(pf, 2, SEEK_CUR);
	ch = fgetc(pf);
	printf("%c\n", ch);
    
    rewind(pf);//等同于fseek(pf,0,SEEK_SET)
    int ret=ftell(pf);
    printf("%d\n",ret);//打印0
	
    fclose(pf);
	pf = NULL;
	return 0;
}

五、文本文件和二进制文件

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

数据在内存中以二进制的形式存储，如果不加转换的输出到外存，就是二进制文件。

如果要求在外存上以ASCII码的形式存储，则需要在存储前转换。以ASCII字符的形式存储的文件就是文本文件。

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

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

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

六、文件结束的判定

6.1 错误使用的feof

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

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

举例：

6.2 正确使用feof

6.2.1 文本文件：

int main()
{
	int c; // 注意：int，非char，要求处理EOF
	FILE* fp = fopen("test.txt", "r");
	if (fp==NULL) 
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	//fgetc 当读取失败的时候或者遇到文件结束的时候，都会返回EOF
	while ((c = fgetc(fp)) != EOF) // 读取文件
	{
		putchar(c);
	}
	printf("\n");
	//判断是什么原因结束的
	if (ferror(fp))//如果读取失败，则ferror(fp)返回值为真
		puts("I/O error when reading\n");
	else if (feof(fp))//如果文件结束，则feof(fp)返回值为真
		puts("End of file reached successfully\n");
	fclose(fp);
	fp = NULL;
	return 0;
}

输出：

6.2.2 二进制文件:

int main()
{
    double a[5] = {1.0,2.0,3.0,4.0,5.0};
    FILE *fp = fopen("test.bin", "wb"); // 必须用二进制模式
    fwrite(a, sizeof(double), 5, fp); // 写 double 的数组
    fclose(fp);
    double b[5];
    fp = fopen("test.bin","rb");
    int ret_code = fread(b, sizeof(double), 5, fp); // 读 double 的数组
    if(ret_code == 5) 
    {
        puts("Array read successfully, contents: ");
        for(int n = 0; n < 5; ++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;
    return 0;
}

输出：

七、文件缓冲区

ANSIC 标准采用**“缓冲文件系统”**处理的数据文件的。

所谓缓冲文件系统是指系统自动地在内存中为程序中每一个正在使用的文件开辟一块“文件缓冲区”。

从内存向磁盘输出数据会先送到内存中的缓冲区，装满缓冲区后才一起送到磁盘上。

如果从磁盘向计算机读入数据，则从磁盘文件中读取数据输入到内存缓冲区（充满缓冲区），然后再从缓冲区逐个地将数据送到程序数据区（程序变量等）。缓冲区的大小根据C编译系统决定的。

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