C语言文件操作

本章重点

1. 为什么使用文件
2. 什么是文件
3. 文件的打开和关闭
4. 文件的顺序读写
5. 文件的随机读写
6. 文本文件和二进制文件
7. 文件读取结束的判定
8. 文件缓冲区

---

一. 为什么使用文件

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

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

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

二. 什么是文件

磁盘上的文件是文件。

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

1.  程序文件

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

2. 数据文件

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

本章讨论的是数据文件。

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

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

3. 文件名

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

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

例如： c:\code\test.txt

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

注：

文件名可以不包含后缀名

文件中不能包含这些字符：\/:*?"<>|，

文件的后缀名决定了一个文件的默认打开方式

文件路径指的是从盘符到该文件所经历的路径中各符号名的集合

三. 文件的打开和关闭

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*的指针变量:

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

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

比如：

2. 文件的打开和关闭 

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

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

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

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

打开失败时，返回空指针

打开成功时，返回指向该文件的起始地址的指针

 打开方式如下：

文件使用方式	含义	如果指定文件不存在
“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;
}

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

int main()
{
	//printf("hehe\n");
	//打开文件
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		//printf("打开文件失败\n");
		printf("%s\n", strerror(errno));
		return 0;
	}
	//关闭文件
	fclose(pf);
	pf = NULL;

	return 0;
}

四. 文件的顺序读写

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

注：

输入流 ---> C语言程序只要运行起来就默认打开三个流

分别是：

stdin ---> 标准输入流

stdout ---> 标准输出流

stderr ---> 标准 错误流

三者的类型都是 FLIE*

函数的使用情况如下：

以 fputc / fgetc为例，其他函数自己去查用法

用法示例：

int main()
{
	FILE* pf = fopen("data.txt", "w");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}

	//写文件
	char ch = 0;
	for (ch = 'a'; ch <= 'z'; ch++)
	{
		fputc(ch, pf);//pf是文件流，写到文件里
        //fputc(ch, stdout)这里的stdout是标准输出流，就打印到屏幕上
	}

	fclose(pf);
	pf = NULL;

	return 0;
}

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

	//读文件
	int ch = 0;//EOF是-1，是整形
	while ((ch = fgetc(pf)) != EOF)
	{
		printf("%c ", ch);
	}

	fclose(pf);
	pf = NULL;

	return 0;
}

剩下的几个函数均展示用法，原型自己查找

//读文件-读一行
int main()
{
	FILE* pf = fopen("data.txt", "r");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	char buf[1000] = {0};
	//读文件
	fgets(buf, 3, pf);
	printf("%s", buf);

	fgets(buf, 3, pf);
	printf("%s", buf);

	fclose(pf);
	pf = NULL;

	return 0;
}

//fputs函数写一行
int main()
{
	FILE* pf = fopen("data.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;
}

利用上述函数拷贝文件：

int main()
{
	//实现一个代码将data.txt 拷贝一份 生成data2.txt
	FILE* pr = fopen("data.txt", "r");
	if (pr == NULL)
	{
		printf("open for reading: %s\n", strerror(errno));
		return 0;
	}

	FILE* pw = fopen("data2.txt", "w");
	if (pw == NULL)
	{
		printf("open for writting: %s\n", strerror(errno));
		fclose(pr);
		pr = NULL;
		return 0;
	}
	//拷贝文件
	int ch = 0;
	while ((ch = fgetc(pr)) != EOF)
	{
		fputc(ch, pw);
	}

	fclose(pr);
	pr = NULL;
	fclose(pw);
	pw = NULL;

	return 0;
}

格式化函数（这里的格式化指的是有格式的数据，如结构体）用例：

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\n", s.name, s.age, s.d);

	fclose(pf);
	pf = NULL;

	return 0;
}

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

二进制函数用例：

//二进制的写
int main()
{
	struct Stu s[2] = { {"张三", 20, 95.5} , {"lisi", 16, 66.5}};

	FILE* pf = fopen("data.txt", "wb");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	//按照二进制的方式写文件
	fwrite(s, sizeof(struct Stu), 2, pf);

	fclose(pf);
	pf = NULL;

	return 0;
}

//二进制的读

int main()
{
	struct Stu s[2] = {0};

	FILE* pf = fopen("data.txt", "rb");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	//按照二进制的方式读文件
	fread(s, sizeof(struct Stu), 2, pf);

	printf("%s %d %lf\n", s[0].name, s[0].age, s[0].d);
	printf("%s %d %lf\n", s[1].name, s[1].age, s[1].d);


	fclose(pf);
	pf = NULL;

	return 0;
}

四. 对比一组函数

scanf/fscanf/sscanf

printf/fprintf/sprintf

printf 与 fprintf 函数的原型：

 

scanf 与 fscanf 函数的原型：

 

 各组函数的对比：

代码示例：

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

五. 文件的随机读写

1. fseek

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

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

origin对应的参数应是下图中的一个：

分别对应的是文件的当前位置开始偏移，文件的末尾开始偏移，文件的起始位置开始偏移 

例子：

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

int main()
{
	FILE * pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	//读文件
	int ch = fgetc(pf);
	printf("%c\n", ch);//a
	ch = fgetc(pf);
	printf("%c\n", ch);//b
	
	//定位文件指针
	fseek(pf, 3, SEEK_CUR);

	ch = fgetc(pf);
	printf("%c\n", ch);//f

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

2. ftell

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

long int ftell ( FILE * stream );

例子：

/* ftell example : getting size of a file */
#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;
}

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

int main()
{
	FILE* pf = fopen("test.txt", "r");
	if (pf == NULL)
	{
		printf("%s\n", strerror(errno));
		return 0;
	}
	//读文件
	int ch = fgetc(pf);
	printf("%c\n", ch);//a
	ch = fgetc(pf);
	printf("%c\n", ch);//b
	
	int ret = ftell(pf);
	printf("%d\n", ret);//2

	rewind(pf);
	//fseek(pf, 0, SEEK_SET);这样也可以做到rwind函数的功能

	ret = ftell(pf);
	printf("%d\n", ret);//0

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

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

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

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

以ASCII字符的形式存储的文件就是文本文件。

一个数据在内存中是怎么存储的呢？ 字符一律以ASCII形式存储，数值型数据既可以用ASCII形式存储，也可以使用二进制形式存储。

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

 测试代码：

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

 七. 文件读取结束的判定

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

二进制文件的例子：

#include <stdio.h>
enum { SIZE = 5 };
int main(void)
{

    double a[SIZE] = { 1.0, 2.0, 3.0, 4.0, 5.0 };
    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);
}

八. 文件缓冲区

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

注：printf本身是不会刷新和缓冲区的，刷新缓冲区的是\n

这里的刷新缓冲区指的是将缓冲区里的数据放入硬盘或者是放入程序数据区时的操作

如果想要更好的了解缓冲区，可以在 linux 操作系统下，写一个死循环，然后用 sleep 函数让系统休息一秒打印，在打印的内容后面分别加上 \n 和不加上 \n ，即可观察到，当没有 \n 时，短时间内不会有内容打印，因为不刷新缓冲区，打印的内容会一直填充缓冲区，直至填满再输出，而当加上 \n 时，马上就打印了，说明 \n 可以刷新缓冲区，让系统立马打印 

include <stdio.h>

int main()
{
	while (1)
	{
		printf("hehe\n");
		Sleep(1000);
	}
	return 0;
}

这里可以得出一个结论：

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