【C语言】15.文件操作

文件操作

1. 什么是文件

磁盘上的文件是文件。 

但是在程序设计中，我们一般谈的文件有两种：程序文件、数据文件 

1.1 程序文件

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

1.2 数据文件

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

讨论的是数据文件。

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

2. 文件名

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

2.1 文件类型

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

2.2 例子

以二进制的形式写到文件中

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

以二进制编译器查看文件

3. 文件缓冲区

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

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

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

如果从磁盘向计算机读入数据，则从磁盘文件中读取数据输入到内存缓冲区（充满缓冲区），

然后再从缓冲区逐个地将数据送到程序数据区（程序变量等）。

缓冲区的大小根据C编译系统决定的。

4. 文件指针

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

每个被使用的文件都在内存中开辟了一个相应的文件信息区，

用来存放文件的相关信息（如文件的名字，文件状态及 文件当前的位置等）。

这些信息是保存在一个结构体变量中的。该结构体类型是有系统声明的，取名FILE.

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结构的变量，这样使用起来更加方便。

4.1 创建一个 FILE* 的指针变量:

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

定义pf是一个指向FILE类型数据的指针变量。

可以使pf指向某个文件的文件信息区（是一个结构体变量）。

通过该文件信息区中的信息就能够访问该文件。

也就是说，通过文件指针变量能够找到与它关联的文件。

5. 文件的打开和关闭

文件在读写之前应该先打开文件，在使用结束之后应该关闭文件。

在编写程序的时候，在打开文件的同时，都会返回一个FILE*的指针变量指向该文件，
也相当于建立了指针和文件的关系。

ANSIC 规定使用fopen函数来打开文件，fclose来关闭文件。

FILE * fopen ( const char * filename, const char * mode );
int fclose ( FILE * stream );

5.1 打开方式如下：

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

5.2 例：

#include <stdio.h>
#include <errno.h>
#include <string.h>
int main()
{
    FILE* pf = fopen("myfile.txt", "r");
    if (pf != NULL)
    {
        printf("%s\n", strerror(errno));
        return 0;
    }

    //打开成功
    //读文件
    
    //关闭文件
    fclose(pf);//关闭文件只是传值操作，关闭后pf仍然存在
    pf = NULL;//所以要将pf设为NULL

    return 0;
}

6. 文件的顺序读写

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

6.1 写文件 - 字符 - fputc函数

fputc函数把参数 char 指定的字符（一个无符号字符）写入到指定的流 stream 中，
并把位置标识符往前移动。

声明：int fputc(int char, FILE *stream)

参数：	
	char -- 这是要被写入的字符。该字符以其对应的 int 值进行传递。
	stream -- 这是指向 FILE 对象的指针，该 FILE 对象标识了要被写入字符的流。

返回值：
	如果没有发生错误，则返回被写入的字符。如果发生错误，则返回 EOF，并设置错误标识符。

#include <stdio.h>
#include <string.h>
#include <errno.h>

int main()
{
	FILE* pfWrite = fopen("test.txt", "w");
	if (pfWrite == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
    
	//写文件
	fputc('h', pfWrite);
	fputc('e', pfWrite);
	fputc('l', pfWrite);
	fputc('l', pfWrite);
	fputc('o', pfWrite);

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

	return 0;
}

6.2 读文件 - 字符 - fgetc函数

头文件：include<stdio.h>

fgetc()函数用于从文件流中读取一个字符，其原型为：
	int fgetc(FILE * stream);

【参数】stream为文件指针。
【返回值】成功返回读取到的字符，读到文件结尾时返回EOF。

说明：fget() 返回的字符实际上是文件流（ FILE 结构体）中位置指针所指向的字符。
fgetc()读取错误时，返回EOF并设置文件错误标志位；ferror()函数可检测此错误。

#include <stdio.h>
#include <string.h>
#include <errno.h>

int main()
{
	FILE* pfRead = fopen("test.txt", "r");
	if (pfRead == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	//读文件
	printf("%c", fgetc(pfRead));//h
	printf("%c", fgetc(pfRead));//e
	printf("%c", fgetc(pfRead));//l
	printf("%c", fgetc(pfRead));//l
	printf("%c", fgetc(pfRead));//o

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

	return 0;
}

6.3 读文件 - 行 - fgets函数

fgets函数从指定的流 stream 读取一行，并把它存储在 str 所指向的字符串内。
当读取 (n-1) 个字符时，或者读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。

声明：char *fgets(char *str, int n, FILE *stream) 

参数：
	str -- 这是指向一个字符数组的指针，该数组存储了要读取的字符串。
    n -- 这是要读取的最大字符数（包括最后的空字符）。通常是使用以 str 传递的数组长度。
    stream -- 这是指向 FILE 对象的指针，该 FILE 对象标识了要从中读取字符的流。
    
返回值：
	如果成功，该函数返回相同的 str 参数。
	如果到达文件末尾或者没有读取到任何字符，str 的内容保持不变，并返回一个空指针。
	如果发生错误，返回一个空指针。

#include <stdio.h>
#include <string.h>

int main()
{
	char buf[1024] = { 0 };
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		return 0;
	}

	//读文件
	fgets(buf, 1024, pf);
	printf("%s", buf);//不用 \n 也可以，本身带有一个换行符
	fgets(buf, 1024, pf);
	printf("%s", buf);

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

	return 0;
}

6.4 写文件 - 行 - fputs函数

 fputs函数把字符串写入到指定的流 stream 中，但不包括空字符。
 
 声明：int fputs(const char *str, FILE *stream)
 
 参数：
 	str -- 这是一个数组，包含了要写入的以空字符终止的字符序列。
	stream -- 这是指向 FILE 对象的指针，该 FILE 对象标识了要被写入字符串的流。

返回值：
	该函数返回一个非负值，如果发生错误则返回 EOF。

#include <stdio.h>
#include <string.h>

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

	//写文件
	fputs("hello", pf);//要换行就要加上 \n
	fputs("world", pf);

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

	return 0;
}

6.5 键盘读写

#include <stdio.h>
#include <string.h>

int main()
{

	//从键盘读取一行文本信息
	char buf[1024] = { 0 };
	fgets(buf, 1024, stdin);//从标准输入流读取
	fputs(buf, stdout);//输出到标准输出流

	//相当于
	gets(buf);
	puts(buf);

	return 0;
}

6.6 格式化的形式写文件 - fprintf函数

#include <stdio.h>
#include <string.h>

struct S
{	
	int n;
	float score;
	char arr[10];
};

int main()
{
	struct S s = { 100,3.14f,"hello" };
	FILE* pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		return 0;
	}

	//格式化的形式写文件
	fprintf(pf, "%d %f %s", s.n, s.score, s.arr);

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

	return 0;
}

格式化的输入数据

#include <stdio.h>
#include <string.h>

struct S
{
	int n;
	float score;
	char arr[10];
};

int main()
{
	struct S s = { 0 };
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		return 0;
	}

	//格式化的输入数据
	fscanf(pf, "%d %f %s", &(s.n), &(s.score), &(s.arr));
	printf("%d %f %s", s.n, s.score, s.arr);

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

	return 0;
}

从键盘输入数据

#include <stdio.h>
#include <string.h>

struct S
{
	int n;
	float score;
	char arr[10];
};

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

	//从键盘输入数据
	fscanf(stdin, "%d %f %s", &(s.n), &(s.score), &(s.arr));
	fprintf(stdout,"%d %f %s", s.n, s.score, s.arr);

	return 0;
}

对比一组函数：

scanf/fscanf/sscanf	
printf/fprintf/sprintf

scanf/printf	是针对标准输入流/标准输出流的格式化输入/输出语句

fscanf/fprintf	是针对所有输入流/所有输出流的格式化输入/输出语句

sscanf/sprintf	sscanf是从字符串中读取格式化的数据
			   sprintf是把格式化数据输出成（存储到)字符串

sscanf/sprintf

#include <stdio.h>
#include <string.h>

struct S
{
	int n;
	float score;
	char arr[10];
};

int main()
{
	struct S s = { 100,3.14f,"abcdef" };
	struct S tmp = { 0 };
	char buf[1024] = { 0 };

	//把格式化的数据转换成字符串存储到buf
	sprintf(buf, "%d %f %s", s.n, s.score, s.arr);
	//printf("%s\n", buf);

	//从buf中读取格式化的数据到tmp中
	sscanf(buf, "%d %f %s", &(tmp.n), &(tmp.score), tmp.arr);

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

	return 0;
}

7. 文件的随机读写

7.2 fseek() 函数

fseek() 函数的声明

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

fseek() 函数的描述

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

设置流 stream 的文件位置为给定的偏移 offset，参数 offset 意味着从给定的 whence 位置查找的字节数。

fseek() 函数的参数

stream – 这是指向 FILE 对象的指针，该 FILE 对象标识了流。

offset – 这是相对 whence 的偏移量，以字节为单位。

whence – 这是表示开始添加偏移 offset 的位置。

#include <stdio.h>

int main()
{
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{	
		return 0;
	}
	/*
		SEEK_SET	文件的开头
		SEEK_CUR	文件指针的当前位置
		SEEK_END	文件的末尾
	*/
	//1.定位文件指针
	//fseek(pf, 2, SEEK_CUR);//c
	//fseek(pf, -2, SEEK_END);//e
	fseek(pf, 2, SEEK_SET);//c

	//2.读取文件
	int ch = fgetc(pf);
	printf("%c\n", ch);//打印定位到的字节

	fclose(pf);
	pf = NULL;

	return 0;
}

7.2 ftell函数

ftell() 函数的声明

long int ftell(FILE *stream);

ftell() 函数的描述

返回给定流 stream 的当前文件位置

ftell() 函数的参数

stream – 这是指向 FILE 对象的指针，该 FILE 对象标识了流

ftell() 函数的返回值

该函数返回位置标识符的当前值。如果发生错误，则返回 -1L，全局变量 errno 被设置为一个正值。

#include <stdio.h>

int main()
{
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		return 0;
	}
	
	//1.定位文件指针
	fseek(pf, 2, SEEK_SET);//c

	int pos = ftell(pf);
	printf("%d\n", pos);//2 - 返回当前文件位置

	fclose(pf);
	pf = NULL;

	return 0;
}

7.3 rewind函数

ftell() 函数的声明

void rewind(FILE *stream);

rewind函数的描述

设置文件位置为给定流 stream 的文件的开头

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

rewind函数的参数

stream – 这是指向 FILE 对象的指针，该 FILE 对象标识了流

rewind 函数的返回值

该函数不返回任何值

#include <stdio.h>

int main()
{
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		return 0;
	}
	
	//1.定位文件指针
	fseek(pf, 2, SEEK_SET);//c

	//2.返回当前文件位置
	int pos = ftell(pf);
	printf("%d\n", pos);//2 - 返回当前文件位置

	//3.回到文件的起始位置
	rewind(pf);

	char ch = fgetc(pf);
	printf("%c\n", ch);//a 回到文件的起始位置“a”

	fclose(pf);
	pf = NULL;

	return 0;
}

8. 文件结束判定

被错误使用的 feof函数

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

#include <stdio.h>
#include <string.h>
#include <errno.h>

int main()
{
	//strerror - 把错误码对应的错误信息的字符串地址返回
	//printf("%s\n", strerror(errno));

	//peror - 比strerror简单，不用引用头文件
	//peror直接把错误信息打印出来，还可以定制想要的提示信息
	FILE* pf = fopen("test2.txt", "r");
	if (pf==NULL)
	{
		perror("hehe");// - hehe: No such file or directory
		return 0;
	}

	//读文件

	fclose(pf);
	pf = NULL;

	return 0;
}

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

   例如：

   ​ fgetc判断是否为EOF.

   ​ fgets判断返回值是否为NULL.

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

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

GitHub代码