Bootstrap

C语言文件操作详解

目录

前言

一. 为什么要使用文件

二. 什么是文件

1. 程序文件

2. 数据文件

3. 文件名

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

四. 文件的打开和关闭

1. 流和标准流

1.1 流

1.2 标准流

2. 文件指针

3. 文件的打开和关闭

五. 文件的顺序读写

1. 顺序读写函数介绍

1.1 fputc与fgetc

 1.1.1 fputc

1.1.1.1 将字符放在文件中

1.1.1.2 将字符放在标准流中

 1.1.2 fgetc

1.1.2.1 从文件中读取字符

1.1.2.2 从标准流中读取字符

 1.1.3 代码示例

1.2 fputs与fgets

 1.2.1 fputs

1.2.1.1 将字符串放在文件中

1.2.1.2 将字符串放在标准流中

 1.2.2 fgets

1.2.2.1 从文件中读取字符串

1.2.2.2 从标准流中读取字符串

 1.2.3 代码示例

2. 函数对比

2.1 printf类

2.1.1 printf

2.1.2 fprintf

2.1.3 sprintf

2.2 scanf类 

2.2.1 scanf

2.2.2 fscanf

2.2.3 sscanf

六. 文件的随机读写

1. fseek

2. ftell

3. rewind

七. 文件读取结束的判定

1. 被错误使用的 feof

2. 文本文件举例

3. 二进制文件举例

八. 文件缓冲区


前言

当我们编写C语言程序时,我们向C语言程序传入的数据会在程序结束后消失。

那么,有没有一种方法能使我们程序的数据保留下来,以后程序启动时再继续使用呢?

答案就是创建一个文件,保存在计算机硬盘中,下次程序启动时读取即可。

C语言也提供了文件操作相关的函数和指针,让我们一起来学习一下吧!

一. 为什么要使用文件

如果没有文件,我们写的程序的数据是存储在电脑的内存中,如果程序退出,内存回收,数据就丢失了,等再次运行程序,是看不到上次程序的数据的,如果要将数据进行持久化的保存,我们可以使用文件。

二. 什么是文件

磁盘(硬盘)上的文件是文件。

但是在程序设计中,我们一般谈的文件有两种:程序文件、数据文件(从文件功能的角度来分类的)。

1. 程序文件

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

2. 数据文件

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

本章讨论的是数据文件。

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

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

3. 文件名

一个文件要有一个唯一的文件标识,以便用戶识别和引用。

文件名包含3部分:文件路径+文件名主干+文件后缀

例如: D:\code\test.txt

文件路径:D:\code\

文件名主干:test

文件后缀:txt

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

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

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

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

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

一个数据在文件中是怎么存储的呢?

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

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

测试代码示例:

#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;
}
10000在⼆进制⽂件中
10000在⼆进制⽂件中

关于上面这些函数的指针的具体作用和用法,会在下面讲解。 

四. 文件的打开和关闭

1. 流和标准流

1.1 流

我们程序的数据需要输出到各种外部设备,也需要从外部设备获取数据,不同的外部设备的输入输出操作各不相同,为了方便程序员对各种设备进行方便的操作,我们抽象出了流的概念,我们可以把流想象成流淌着字符的河。

C程序针对文件、画面、键盘等的数据输入输出操作都是通过流操作的。

一般情况下,我们要想向流里写数据,或者从流中读取数据,都是要打开流,然后操作。

1.2 标准流

那为什么我们从键盘输入数据,向屏幕上输出数据,并没有打开流呢?

那是因为C语言程序在启动的时候,默认打开了3个流:

stdin - 标准输入流,在大多数的环境中从键盘输入,scanf函数就是从标准输入流中读取数据。

stdout - 标准输出流,大多数的环境中输出至显示器界面,printf函数就是将信息输出到标准输出流中。

stderr - 标准错误流,大多数环境中输出到显示器界面。

这是默认打开了这三个流,我们使用scanf、printf等函数就可以直接进行输入输出操作的。

stdin、stdout、stderr 三个流的类型是: FILE* ,通常称为文件指针

C语言中,就是通过 FILE* 的文件指针来维护流的各种操作的。

2. 文件指针

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

每个被使用的文件都在内存中开辟了一个相应的文件信息区,用来存放文件的相关信息(如文件的名字,文件状态及文件当前的位置等)。这些信息是保存在一个结构体变量中的。该结构体类型是由系统声明的,取名 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指向某个文件的文件信息区(是一个结构体变量)。通过该文件信息区中的信息就能够访问该文件。也就是说,通过文件指针变量能够间接找到与它关联的文件

3. 文件的打开和关闭

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

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

ANSI C 规定使用 fopen 函数来打开文件, fclose 来关闭文件。

//打开⽂件
FILE* fopen ( const char* filename, const char* mode );

//关闭⽂件
int fclose ( FILE* stream );

mode表示文件的打开模式,下面都是文件的打开模式:

文件使用方式

含义

如果指定文件不存在

“r”(只读)

为了输入数据,打开一个已经存在的文本文件

出错

“w”(只写)

为了输出数据,打开一个文本文件

建立一个新的文件

“a”(追加)

向文本文件尾添加数据

建立一个新的文件

“rb”(只读)

为了输入数据,打开一个二进制文件

出错

“wb”(只写)

为了输出数据,打开一个二进制文件

建立一个新的文件

“ab”(追加)

向一个二进制文件尾添加数据

建立一个新的文件

“r+”(读写)

为了读和写,打开一个文本文件

出错

“w+”(读写)

为了读和写,建议一个新的文件

建立一个新的文件

“a+”(读写)

打开一个文件,在文件尾进行读写

建立一个新的文件

“rb+”(读写)

为了读和写打开一个二进制文件

出错

“wb+”(读写)

为了读和写,新建一个新的二进制文件

建立一个新的文件

“ab+”(读写)

打开一个二进制文件,在文件尾进行读和写

建立一个新的文件

示例代码:

/* fopen fclose example */
#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;
}

这一段代码创建了一个名为pFile的文件指针,以只读的方式打开一个名为myfile.txt的文本文件,要判断文件是否打开成功,就要判断pfile是否为NULL,非空才能继续操作,由于我们事先没有创建这个文件,程序就会自动的在程序路径下创建这个文件,然后对这个文件进行写入,写入完成后关闭文件,并将文件指针置空。

自动创建的文本文件

我们打开文件路径,发现果然有这样一个文件,存放着我们想要存放的内容

五. 文件的顺序读写

1. 顺序读写函数介绍

函数名

功能

适用于

fgetc

字符输入函数

所有输入流

fputc

字符输出函数

所有输出流

fgets

文本行输入函数

所有输入流

fputs

文本行输出函数

所有输出流

fscanf

格式化输入函数

所有输入流

fprintf

格式化输出函数

所有输出流

fread

二进制输入

文件

fwrite

二进制输出

文件

上面说的适用于所有输入流一般指适用于标准输入流和其他输入流(如文件输入流);所有输出流一般指适用于标准输出流和其他输出流(如文件输出流)。

1.1 fputc与fgetc

 1.1.1 fputc

 函数原型式:

int fputc ( int character, FILE* stream );

这个函数的作用是将字符放在流里,同时返回这个字符的整型值

1.1.1.1 将字符放在文件中
#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	fputc('a', pf);
	fclose(pf);
	pf = NULL;
	return 0;
}

 运行结果

1.1.1.2 将字符放在标准流中
#include <stdio.h>

int main()
{
	fputc('a', stdout);
	return 0;
}

运行结果

 1.1.2 fgetc

  函数原型式:

int fgetc ( FILE* stream );

这个函数的作用是从流里读取字符,同时返回这个字符的整型值

1.1.2.1 从文件中读取字符
#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	char c = 0;
	c = fgetc(pf);
	printf("%c\n", c);
	fclose(pf);
	pf = NULL;
	return 0;
}

运行结果

1.1.2.2 从标准流中读取字符
#include <stdio.h>

int main()
{
	int i = 0;
	scanf("%d", stdin);
	i = fgetc(stdin);
	printf("%c", i);
	return 0;
}

运行结果

 1.1.3 代码示例
#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen:write");
		return 1;
	}
	
	char c = 0;
	for (c = 'a'; c <= 'z'; c++)//fputc输入a~z的字符
	{
		fputc(c, pf);
	}
	fclose(pf);//关闭文件
	pf = NULL;

	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen:read");
		return 1;
	}

	while ((c = fgetc(pf)) != EOF)//fgetc读取字符
	{
		printf("%c ", c);
	}

	fclose(pf);
	pf = NULL;

	return 0;
}

文件结果

运行结果

1.2 fputs与fgets

 1.2.1 fputs

  函数原型式:

int fputs ( const char* str, FILE* stream );
1.2.1.1 将字符串放在文件中
#include <stdio.h>

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

运行结果

1.2.1.2 将字符串放在标准流中
#include <stdio.h>

int main()
{
	fputs("abcdefg", stdout);
	return 0;
}

运行结果

 1.2.2 fgets

  函数原型式:

char* fgets ( char* str, int num, FILE* stream );
1.2.2.1 从文件中读取字符串
#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	char arr[7] = "XXXXXXX";
	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	fgets(arr, 5, pf);
	fclose(pf);
	pf = NULL;
	printf(arr);
	return 0;
}

文件情况

运行结果

1.2.2.2 从标准流中读取字符串
#include <stdio.h>

int main()
{
	char arr[7] = "XXXXXXX";
	fgets(arr, 5, stdin);
	printf(arr);
	return 0;
}

运行结果

 1.2.3 代码示例
#include <stdio.h>

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

	fputs("Hello World\n", pf);
	fputs("Nice to meet you!\n", pf);
	fclose(pf);//关闭文件
	pf = NULL;

	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen:read");
		return 1;
	}

	char arr[20] = { 0 };
	while (fgets(arr,20,pf) != NULL)//fgets读取字符串 
	{
		printf(arr);
	}

	fclose(pf);
	pf = NULL;

	return 0;
}

文件结果运行结果

2. 函数对比

2.1 printf类

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

printf这个函数相信你已经不陌生了,frintf的作用是格式化输出到标准输出流中,从而显示到你的显示屏上,并返回输出的字符总数,这里就不多赘述了

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

返回值:

成功后,将返回写入的字符总数。

如果发生写入错误,则设置错误指示符(ferror)并返回负数。

如果写入宽字符时发生多字节字符编码错误,则errno 设置为EILSEQ并返回负数。

#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "w");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	struct S
	{
		int i;
		char c;
		double d;
	};
	struct S s = { 10,'a' ,2.5 };
	fprintf(pf, "%d %c %lf", s.i, s.c, s.d);
	fclose(pf);
	pf = NULL;
	return 0;
}

运行结束后文件内容

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

成功后,将返回写入的字符总数。此计数不包括自动追加在字符串末尾的其他空字符。
失败时,返回负数。


 

#include <stdio.h>

int main()
{
	char arr[50] = { 0 };
	size_t sz = sizeof(arr) / sizeof(arr[0]);
	for (int i = 0; i < sz; i++)
	{
		arr[i] = 'X';
	}
	struct S
	{
		int i;
		char c;
		double d;
	};
	struct S s = { 15,'b' ,7.5 };
	sprintf(arr, "%d %c %lf", s.i, s.c, s.d);
	printf(arr);
	return 0;
}

 运行结果

2.2 scanf类 

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

scanf相信你已经用过很多次了,scanf的作用是从输入缓冲区中读取对应格式的数据,并返回读取成功的数据个数,这里也不多赘述了

2.2.2 fscanf
int fscanf ( FILE * stream, const char * format, ... );
从流中读取格式化数据

从流中读取数据,并根据参数格式将它们存储到其他参数所指向的位置。

#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	struct S
	{
		int i;
		char c;
		double d;
	};
	struct S s = { 0 };
	fscanf(pf, "%d %c %lf", &(s.i), &(s.c), &(s.d));
	printf("%d %c %lf\n", s.i, s.c, s.d);
	fclose(pf);
	pf = NULL;
	return 0;
}

运行结果

当然,也可以将pf的文件指针更改为stdout,这样就可以直接输出到显示器上 

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

成功后,该函数返回成功填充的参数列表中的项数。此计数可以与预期的项目数匹配,也可以在匹配失败的情况下更少(甚至为零)。
如果在成功解释任何数据之前发生输入失败,则返回 EOF。 

#include <stdio.h>

int main()
{
	char arr[20] = "15,b,7.5";
	struct S
	{
		int i;
		char c;
		double d;
	};
	struct S s = { 0 };
	sscanf(arr, "%d%*c%c%*c%lf", &(s.i), &(s.c), &(s.d));
	printf("%d,%c,%lf\n", s.i, s.c, s.d);
	return 0;
}

运行结果

六. 文件的随机读写

1. fseek

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

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

参数1:该文件的文件指针 

参数2:想要移动的字符位数(正数为向后移,负数为向前移)

 参数3(origin):从文件的那个位置开始

Constant参考位置
SEEK_SET文件开头
SEEK_CUR文件指针的当前位置
SEEK_END文件末尾 

返回值:

如果成功,该函数将返回零。

否则,它将返回非零值。

如果发生读取或写入错误,则设置错误指示符 (ferror)。

例子:

初始文件内容

#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//读文件
	int ch = fgetc(pf);
	printf("%c\n", ch);//a
	fseek(pf, -1, SEEK_END);//让文件指针指向文件末尾前一个字符
	printf("%c\n", fgetc(pf));//打印最后一个字符

	fclose(pf);
	pf = NULL;

	return 0;
}

运行结果

2. ftell

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

long int ftell ( FILE* stream );

例子:

初始文件内容

#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//读文件
	fseek(pf, 0, SEEK_END);//让文件指针指向文件末尾
	printf("%d\n", ftell(pf));//打印文件末尾到开头的偏移量

	fclose(pf);
	pf = NULL;

	return 0;
}

运行结果

3. rewind

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

void rewind ( FILE* stream );

例子:

初始文件内容

#include <stdio.h>

int main()
{
	FILE* pf = NULL;
	pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		perror("fopen");
		return 1;
	}
	//读文件
	fseek(pf, 0, SEEK_END);//让文件指针指向文件末尾
	rewind(pf);//让文件指针指向文件开头
	int ch = fgetc(pf);
	printf("%c\n", ch);//a

	fclose(pf);
	pf = NULL;

	return 0;
}

运行结果

七. 文件读取结束的判定

1. 被错误使用的 feof

牢记:在文件读取过程中,不能用feof函数的返回值直接来判断文件的是否结束

feof 的作用是:当文件读取结束的时候,判断读取结束的原因是否是遇到文件尾结束

1. 文本文件读取是否结束,判断返回值是否为 EOF ( fgetc ),或者 NULL ( fgets )

例如:

fgetc 判断是否为 EOF .

fgets 判断返回值是否为 NULL .

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

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

2. 文本文件举例

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

初始文件内容

运行结果

3. 二进制文件举例

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

八. 文件缓冲区

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

#include <stdio.h>
#include <windows.h>
//VS2019 WIN11环境测试
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语言在操作文件的时候,需要做刷新缓冲区或者在文件操作结束的时候关闭文件。

如果不做,可能导致读写文件的问题。

;