文件操作、文件读写

文件的打开和关闭

文件指针

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

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

文件的打开和关闭

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

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

fopen函数打开文件

FILE * fopen ( const char * filename, const char * mode );

filename：要打开的文件的名称。其值应遵循运行环境的文件名规范，并且可以包括路径。

mode：文件访问模式

返回值：

如果文件成功打开，函数将返回一个指向file对象的指针，该指针可用于在将来的操作中标识流。否则，将返回空指针。

文件访问模式表：

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

fclose函数关闭文件

int fclose ( FILE * stream );

stream：指向指定要关闭的流的FILE对象的指针。

返回值：

如果流成功关闭，则返回零值。失败时，返回EOF。

代码示例

#include <stdio.h>

int main()
{
	//打开文件
	FILE* pf = fopen("myfile.txt", "w");
	if (pf)
	{
		/*对文件进行操作*/

		//关闭文件
		fclose(pf);
	}

	return 0;
}

文件的顺序读写

字符输入输出函数

字符输入函数 fgetc：

int fgetc ( FILE * stream );

stream：指向标识输入流的FILE对象的指针。

返回值：

成功后，返回字符读取（提升为int值）。

返回类型为int，以适应表示失败的特殊值EOF：

如果位置指示器位于文件末尾，则函数返回EOF并设置流的EOF指示器（feof）。

如果发生其他读取错误，函数也会返回EOF，但会设置其错误指示器（feror）。

字符输出函数 fputc：

int fputc ( int character, FILE * stream );

character：要写入的字符的int提升。写入时，该值在内部转换为无符号字符。

stream：指向指定输出流的FILE对象的指针。

返回值：

成功后，将返回写入的字符。

如果发生写入错误，则返回EOF并设置错误指示器（feror）。

代码示例

#include <stdio.h>

int main()
{
	FILE* pf = fopen("myfile.txt", "w+");
	if (pf)
	{
		//把A-F写到文件中
		int i = 0;
		for (i = 'A'; i <= 'F'; i++)
		{
			fputc(i, pf);
		}

		//让文件指针回到文件开头
		rewind(pf);

		int c = 0;
		//读取文件的内容
		while ((c = fgetc(pf)) != EOF)
		{
			printf("%c", c);
		}

		fclose(pf);
	}

	return 0;
}

文本行输入输出函数

文本行输入函数 fgets

char * fgets ( char * str, int num, FILE * stream );

str：指向存储读取到的字符串的字符数组的指针。

num：要复制到str中的最大字符数（包括终止的空字符）。

stream：指向标识输入流的FILE对象的指针。

返回值：

成功后，函数返回str。

如果在尝试读取字符时遇到文件结尾，则设置eof指示符（feof）。如果读取的内容为空，则返回的指针为空指针（str的内容保持不变）。

如果发生读取错误，将设置错误指示符（ferror）并返回空指针（但str指向的内容可能已更改）。

文本行输出函数 fputs

int fputs ( const char * str, FILE * stream );

str：要写入流的内容的C字符串。

stream：指向指定输出流的FILE对象的指针。

返回值：

成功后，将返回非负值。

出错时，函数返回EOF并设置错误指示器（feror）。

代码示例

#include <stdio.h>

int main()
{
	FILE* pf = fopen("myfile.txt", "w+");
	if (pf)
	{
		//把abcdefghij写到文件中
		fputs("abcdefghij", pf);

		//让文件指针回到文件开头
		rewind(pf);

		char* mystring[100];
		//读取文件的内容
		while (fgets(mystring, 100, pf) != NULL)
			;

		printf("%s", mystring);
		fclose(pf);
	}

	return 0;
}

格式化输入输出字符

格式化输入字符 fscanf

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

stream：指向标识输入流的FILE对象的指针。

format：读取何种格式的数据的标识符

…：读取的数据存储到此变量

返回值：

成功时，函数返回参数列表中成功填充的项数。由于匹配失败、读取错误或到达文件末尾，此计数可能与预期的项目数相匹配，也可能小于（甚至为零）。

如果在读取时发生读取错误或到达文件末尾，则会设置正确的指示器（feof或feror）。并且，如果在成功读取任何数据之前发生任何一种情况，则返回EOF

格式化输出字符 fprintf

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

stream：指向指定输出流的FILE对象的指针。

format：输出何种格式的数据的标识符

…：输出的变量

返回值

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

如果发生写入错误，则设置错误指示器（ferror）并返回负数。

代码示例

int main()
{
	FILE* pf = fopen("myfile.txt", "w+");
	if (pf)
	{
		//以格式输出把数据写到文件中
		fprintf(pf, "%d %f %s", 8, 3.14, "hello");

		//让文件指针回到文件开头
		rewind(pf);

		int a;
		float f;
		char str[100];
		//以格式输入把数据写到程序中
		fscanf(pf, "%d %f %s", &a, &f, str);
		printf("%d %f %s", a, f, str);
		fclose(pf);
	}

	return 0;
}

二进制输入输出函数

二进制输入函数 fread

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

ptr：指向大小至少为（sizecount）字节的内存块的指针，转换为void。

size：要读取的每个元素的大小（字节）。size_t是无符号整数类型。

count：元素的数量，每个元素的大小为字节。size_t是无符号整数类型。

stream：指向标识输入流的FILE对象的指针。

返回值：

返回成功读取的元素总数。

如果此数字与计数参数不同，则可能发生读取错误，或者在读取时到达文件末尾。在这两种情况下，都设置了适当的指示器，可以分别用feror和feof进行检查。

如果大小或计数为零，则函数返回零，流状态和ptr指向的内容都保持不变。

size_t是无符号整数类型

二进制输出函数 fwrite

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

ptr：指向要写入的元素数组的指针，转换为常量void*

size：要写入的每个元素的字节大小。size_t是无符号整数类型。

count：元素的数量，每个元素的大小为字节。size_t是无符号整数类型。

stream：指向指定输出流的FILE对象的指针。

返回值：

返回成功写入的元素总数。

如果此数字与计数参数不同，则写入错误会阻止函数完成。在这种情况下，将为流设置错误指示器（feror）。

如果大小或计数为零，则函数返回零，错误指示器保持不变。

size_t是无符号整数类型。

代码示例

int main()
{
	FILE* pf = fopen("myfile.txt", "w+");
	if (pf)
	{
		int arr1[10] = { 1,2,3,4,5,6,7,8,9,10 };
		//以二进制输出的方式把数据写到文件中
		fwrite(arr1, sizeof(int), sizeof(arr1) / sizeof(int), pf);

		//让文件指针回到文件开头
		rewind(pf);

		int arr2[10];
		//以二进制输入的方式把数据写到程序中
		fread(arr2, sizeof(int), sizeof(arr2) / sizeof(int), pf);
		int i = 0;
		for (i = 0; i < 10; i++)
		{
			printf("%d ", arr2[i]);
		}
		fclose(pf);
	}

	return 0;
}

文件的随机读写

fseek函数

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

stream：指向标识流的FILE对象的指针。

offset：相对 origin 的偏移量，以字节为单位。

origin：这是表示开始添加偏移 offset 的位置。它一般指定为下列常量之一：

常量	位置
SEEK_SET	文件开始
SEEK_CUR	文件指针的当前位置
SEEK_END	文件结尾

返回值：

如果成功，则该函数返回零，否则返回非零值。

代码示例

int main()
{
	FILE* pf = fopen("myfile.txt", "w+");
	if (pf)
	{
		fputs("This is a string.", pf);
		fseek(pf, 10, SEEK_SET);
		fputs("xxx", pf);

		//让文件指针回到文件开头
		rewind(pf);

		char str[100];
		while (fgets(str, 100, pf) != NULL)
			;
		printf("%s", str);

		fclose(pf);
	}

	return 0;
}

运行结果

This is a xxxing.

ftell函数

long int ftell ( FILE * stream );

stream：指向标识流的FILE对象的指针。

返回值：

成功后，返回位置指示器的当前值。

失败时，返回-1L，并将errno设置为系统特定的正值。

代码示例

int main()
{
	FILE* pf = fopen("myfile.txt", "w+");
	if (pf)
	{
		fputs("This is a string.", pf);
		fseek(pf, 10, SEEK_SET);

		int a = ftell(pf);

		printf("%d", a);
		fclose(pf);
	}

	return 0;
}

运行结果

10

rewind函数

void rewind ( FILE * stream );

stream：指向标识流的FILE对象的指针。

代码示例

int main()
{
	FILE* pf = fopen("myfile.txt", "w+");
	if (pf)
	{
		fputs("This is a string.", pf);
		//让文件指针回到文件开头
		rewind(pf);
		fputs("xxxx", pf);

		rewind(pf);
		char str[100];
		while (fgets(str, 100, pf) != NULL)
			;
		printf("%s", str);
		fclose(pf);
	}

	return 0;
}

运行结果

xxxx is a string.

文件读取结束的判定

1. fgetc 判断是否为 EOF .

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

3. fread判断返回值是否小于实际要读的个数。

注：

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

而是应用于当文件读取结束的时候，判断是读取失败结束，还是遇到文件尾结束。

本文出现任何错误，欢迎留言批评指正。