C语言文件操作

1.什么是文件

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

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

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

2.文件名

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

3.文件类型

根据数据的组织形式，数据文件被称为文本文件或者二进制文件。
数据在内存中以二进制的形式存储，如果不加转换的输出到外存，就是二进制文件。
如果要求在外存上以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);//二进制的形式写到文件中（每次写4个字节，一共写一次）
	fclose(pf);
	pf = NULL;
	return 0;
}

4.文件缓冲区

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

5.文件指针

缓冲文件系统中，关键的概念是“文件类型指针”，简称“文件指针”。
每个被使用的文件都在内存中开辟了一个相应的文件信息区，用来存放文件的相关信息（如文件的名字，文件状态及文件当前的位置等）。这些信息是保存在一个结构体变量中的。该结构体类型是有系统声明的，取名FILE.例如,VS2010编译环境提供的 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指向某个文件的文件信息区（是一个结构体变量）。通过该文件信息区中的信息就能够访问该文件。也就是说，通过文件指针变量能够找到与它关联的文件。
比如：

6.文件的打开和关闭

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

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

打开方式如下：

"r"
	只读，文件必须已经存在
"w"
	只写，如果文件不存在则创建，如果文件已经存在则把文件长度截断为0字节再
	重写，也就是替换掉原来的文件内容。（清空原来内容重新写）
"a"
	只能在文件末尾追加数据，如果文件不存在则创建。
"r+"
	允许读和写，文件必须已经存在。（只是逐渐覆盖原来的内容）
"w+"
	允许读和写，如果文件不存在则创建，如果文件已经存在则把文件长度截断为0字
	节再创建。
"a+"
	允许读和追加数据，如果文件不存在则创建。

举个例子：

/* fopen fclose example */
#include <stdio.h>
int main ()
{
	FILE * pFile;
	//以w的方式打开如果文件不存在则创建该文件，如果已经存在则清空原有内容
	pFile = fopen ("myfile.txt","w");
	if (pFile!=NULL)
 	{
    	fputs ("fopen example",pFile);
    	fclose (pFile);
	}
	return 0; 
}

7.文件的顺序读写

这里需要注意的是fread和fwrite是和wb配合使用的，千万不能和w配合使用了。

//错误的使用
#include <stdio.h>
int main()
{
	int a = 10000;
	FILE *pf = fopen("test.txt", "w");
	fwrite(&a, 1, 5, pf);//二进制的形式写到文件中（每次写1个字节，一共写5次）
	//fprintf(pf, "%d", a);
	fclose(pf);
	pf = NULL;
	return 0;
}

//正确的使用
#include <stdio.h>
int main()
{
	int a = 10000;
	//char *a = "hello";
	FILE *pf = fopen("test.txt", "wb");
	fwrite(&a, 1, 4, pf);//二进制的形式写到文件中（每次写1个字节，一共写4次）
	//fprintf(pf, "%d", a);
	fclose(pf);
	pf = NULL;
	return 0;
}

//正确的使用
#include <stdio.h>
int main()
{
	int b = 10000;
	//char *a = "hello";
	FILE *pf = fopen("test.txt", "w");
	//fwrite(&b, 1, 4, pf);
	//fwrite(a, 1, 4, pf);//二进制的形式写到文件中（每次写1个字节，一共写4次）
	fprintf(pf, "%d", b);
	fclose(pf);
	pf = NULL;
	return 0;
}

fgetc 函数说明：
作用：从文件指针指向的文件流中读取一个字符，读取一个字节后，标记位置后移一个字节
格式：int fgetc(FILE *stream);
返回值：返回所读取的一个字节，如果读到文件末尾或者读取出错时返回EOF(EOF是文件结束
标识符,一般值为-1)
参数说明：
    *stream：文件指针，从该文件指针指向的文件中读取一个字符，标记然后将光标后移一个字节

fputc 函数说明：
作用：将指定字符写到文件指针所指向的文件的当前写指针位置上
格式：int fputc (char c, File *fp);
返回值：在正常调用情况下，函数返回写入文件的字符的ASCII码值，出错时，返回EOF
参数说明：
    c：需要写入的字符
    *fp：文件指针，在当前文件指针所指向的文件的当前写指针位置上写入一个字符c，然后文件内
    部写指针会自动后移一个字节位置

fgets 函数说明：
作用：从文件结构体指针stream中读取数据，每次读取一行。该函数从stream所指的文件中读取
以'\n'结尾的一行（包括'\n'在内）存储到缓冲区buf中，并且在该行末尾加上一个'\0'组成完整
的字符串。    如果文件的一行太长，fgets从文件中读了bufsize-1个字符还没读到'\n'，就把
已经读到的size-1个字符再加上一个'\0'存入缓冲区并返回，文件中剩下的半行可以在下次调用
fgets时继续读。    如果fgets读到文件末尾的最后几个字符，不管是不是以'\n'结尾都加上一
个'\0'存入缓冲区并返回。下次再调用fgets时读写位置已经到达文件末尾，则返回NULL。
格式：char *fgets(char *buf, int bufsize, FILE *stream);
返回值：函数成功将返回buf，失败或读到文件结尾返回NULL。因此我们不能直接通过fgets的
返回值来判断函数是否是出错而终止的，应该借助feof函数或者ferror函数来判断。
参数说明：
    *buf: 字符型指针，指向用来存储所得数据的地址。  
    bufsize: 整型数据，指明存储数据的大小。  
    *stream: 文件指针，将要读取的文件流。
注意：对于fgets来说，'\n'是一个特别的字符串，而'\0'并无任何特别之处，如果读到'\0'
就当做普通字符读入。如果文件中存在'\0'字符（或者说字节0），调用fgets之后就无法判断
缓冲区中的'\0'究竟是从文件读上来的还是由fgets自动添加的，所以fgets只适合读文本文件
而不适合读二进制文件，并且文本文件中的所有字符都应该是可见字符，不能有'\0'。

fputs 函数说明：
作用：向指定的文件写入一个字符串（不写入字符串结束标记符‘\0’）
格式：int fputs(char *str, FILE *fp);
返回值：若成功返回0，失败返回EOF
参数说明：
    *str: 需要写入的字符串   
    *fp: 文件指针，将要写入的文件流
    
 int puts(const char *s);
 puts将字符串s写到标准输出（不包括结尾的'\0'），然后自动写一个'\n'到标准输出。

fprintf 函数说明：
作用：格式化后输出到文件中
格式：int fprintf (FILE*  stream, const char*  format, [argument]);
返回值：若成功返回值是输出的字符数，当发生错误时返回一个负值
参数说明：
    *stream：文件指针
    *format：输出格式
    [argument]：附加参数列表
注：用法与printf函数类似，这里只是参数多了一个文件指针，将格式后的结果输出到文件中

fscanf 函数说明：
作用：从一个流中执行格式化输入
格式：int fscanf(FILE* stream,constchar* format,[argument]);
返回值：成功返回读入的参数的个数，失败返回EOF。
参数说明：
    *stream：文件指针
    *format：格式字符串
    [argument]：输入列表
注：用法与scanf函数类似

fprintf和fscanf的例子：

#include <stdio.h>
struct Stu
{
	char name[20];
	int age;
	float score;
};

//int main()
//{
//	struct Stu s = {"张三", 20, 55.5f};
//	int ch = 0;
//	char buf[20] = {0};
//	FILE* pf = fopen("test.txt", "w");
//	if(pf == NULL)
//	{
//		return 0;
//	}
//	//写文件
//	fprintf(pf, "%s %d %f", s.name, s.age, s.score);
//	fclose(pf);
//	pf = NULL;
//	return 0;
//}

int main()
{
	struct Stu s = {0};
	int ch = 0;
	char buf[20] = {0};
	FILE* pf = fopen("test.txt", "r");
	if(pf == NULL)
	{
		return 0;
	}
	//读文件
	fscanf(pf, "%s %d %f", s.name, &(s.age), &(s.score));
	printf("%s %d %f\n", s.name, s.age, s.score);

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

第一段程序的结果：

第二段程序的结果：

fread 函数说明：
作用：从一个文件流中读数据，最多读取count个元素，每个元素size字节
格式：size_t fread ( void *buffer, size_t  size, size_t  count, FILE *stream) ;
返回值：如果调用成功返回实际读取到的元素个数，如果不成功或读到文件末尾返回0
参数说明：
    *buffer：用于接收数据的内存地址
    size：要读的每个数据项的字节数，单位是字节
    count：要读count个数据项，每个数据项size个字节
    *stream：文件指针
注：这个函数以二进制形式对文件进行操作，不局限于文本文件 

fwrite 函数说明：
作用：向文件写入一个数据块
格式：size_t fwrite(const void* buffer, size_t size, size_t count, FILE* stream);
返回值：返回实际写入的数据块数目
参数说明：
    *buffer：待写入的数据的内存地址
    size：要写入内容的单字节数
    count：要进行写入size字节的数据项的个数
    *stream：文件指针
注：这个函数以二进制形式对文件进行操作，不局限于文本文件 

对比一组函数

scanf/fscanf/sscanf

1、scanf为标准格式化输入，从标准输入流（stdin控制台）输入数据
2、int fscanf(文件指针，格式字符串，输入列表);
功 能: 从一个流中执行格式化输入。
用 法: int fscanf(FILE *stream, char *format,[argument...]);
如:
	FILE *fp;
	char a[10];
	int b;
	double c;
	fscanf(fp,"%s%d%lf",a,&b,&c)
返回值：整型，成功读入的参数的个数
//sscanf将一个字符串转为结构体放到一个结构体变量中（前提是字符串中放了一个结构体）
3、sscanf是一个很好用的函数，利用它可以从字符串中取出整数、浮点数和字符串
等等。它的使用方法简单，特别对于整数和浮点数来说。但新手可能并不知道处理字符串时的
一些高级用法，这里做个简要说明吧。
	1. 常见用法。
	char str[512] = {0};
	sscanf("123456 ", "%s", str);
	printf("str=%s\n", str);
	
	2. 取指定长度的字符串。如在下例中，取最大长度为4字节的字符串。
	sscanf("123456 ", "%4s", str);
	printf("str=%s\n", str);//str的值为1234
	
	3. 取到指定字符为止的字符串。如在下例中，取遇到空格为止字符串。
	sscanf("123456 abcdedf", "%[^ ]", str);//注意^后面有一空格
	printf("str=%s\n", str);//123456
	
	4. 取仅包含指定字符集的字符串。如在下例中，取仅包含1到9和小写字母的字符串。
	sscanf("123456abcdedfBCDEF", "%[1-9a-z]", str);
	printf("str=%s\n", str);//123456abcdedf
	
	5. 取到指定字符集为止的字符串。如在下例中，取遇到大写字母为止的字符串。
	sscanf("123456abcdedfBCDEF", "%[^A-Z]", str);
	printf("str=%s\n", str);//123456abcdedf

sscanf和sprintf的例子：

#include <stdio.h>
struct Stu
{
	char name[20];
	int age;
	float score;
};
//序列化和反序列化
int main()
{
	char buf[50] = {0};
	struct Stu tmp = {0};
	struct Stu s = {"张三", 20, 55.5f};
	//把结构体转换为字符串
	sprintf(buf, "%s %d %f", s.name, s.age, s.score);
	printf("%s\n", 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;
}

printf/fprintf/sprintf

1.printf
格式化标准输出。
2fprintf
格式化后输出到文件中。
3.sprintf
把结构体转换为字符串（格式化输出到字符串）

8.文件的随机读写

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

int fseek( FILE *stream, long offset, int origin );
//第二个参数为正表示右移，为负表示左移

例子：

#include <stdio.h>
int main()
{
	FILE *pFILE;
	pFILE = fopen("example.txt", "wb");
	fputs("This is an apple.", pFILE);
	fseek(pFILE, 9L, SEEK_SET);
	fputs(" sam", pFILE);
	fclose(pFILE);
	pFILE = NULL;
	return 0;
}
//SEEK_SET     文件开头   0
//SEEK_CUR     当前位置   1
//SEEK_END     文件结尾   2
//fseek(fp, 100L, SEEK_SET)把fp指针移动到离文件开头100字节处
//fseek(fp, 100L, 0)把fp指针移动到离文件开头100字节处
//fseek(fp, 100L, SEEK_CUR)把fp指针移动到离指针当前位置100字节处
//fseek(fp, 100L, 1)把fp指针移动到离指针当前位置100字节处
//fseek(fp, 100L, SEEK_END)把fp指针移动到离文件结尾100字
//节处（这里说的文件结尾是EOF，不是字符串结尾的'\0'）
//fseek(fp, 100L, 2)把fp指针移动到离文件结尾100字节处

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

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

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

9.文件结束判定

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

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

正确的使用：
文本文件的例子：

#include <stdio.h>
#include <stdlib.h>

int main()
{
	int c;
	FILE *fp = fopen("test.txt", "r");
	if (!fp)
	{
		perror("File opening failed");//The perror function prints an error message to stderr
		return EXIT_FAILURE;
	}
	//fgetc  当读取失败的时候或者遇到文件结束的时候，都会返回EOF
	while ((c = fgetc(fp)) != EOF)
	{
		putchar(c);
	}
	//判断是什么原因结束的
	if (ferror(fp))
	{
		puts("I/O error when reading");
	}
	else if (feof(fp))
	{
		//If no error has occurred on stream, ferror returns 0
		//Otherwise, it returns a nonzero value
		puts("End of file reached successfully");
	}
	fclose(fp);
	return 0;
}

二进制文件的例子

#include <stdio.h>
enum{SIZE = 5};
int main()
{
	double a[SIZE] = {1.0, 2.0, 3.0, 4.0, 5.0};
	double b = 0.0;
	size_t ret_code = 0;
	FILE *fp = fopen("test.bin", "wb");
	fwrite(a, sizeof(*a), SIZE, fp);//写double的数组
	fclose(fp);
	fp = fopen("test.bin", "rb");
	//读double的数组
	while ((ret_code = fread(&b, sizeof(double), 1, fp)) >= 1)
	{
		printf("%lf\n", b);
	}
	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;
}