【C++ 语言】文件操作 ( fopen | fprintf | fscanf | fgets | fputc | fgetc | ofstream | ifstream )

I C 函数 fopen 打开文件

---

跨平台开发时使用 C++ 对文件读写不经常使用 , 主要使用 C 语言对文件进行读写操作 ;

1. C 文件打开 :

• ① 头文件 : stdio.h
• ② 原型 : FILE* fopen ( const char* path , const char* mode ) ;

2. 参数解析 :

• ① const char* path : 要打开的文件路径 , 可以是相对路径 , 也可以是绝对路径 ;
• ② const char* mode : 打开文件的模式 ;

3. 文件打开模式只读或只写操作 :

• ① " r " : 打开已经存在的文本文件 , 只读操作 ;
• ② " w " : 打开文本文件 , 只写操作 , 从开始开始写入内容 ;
  • a. 文件不存在 : 创建新文件 , 从开头写入内容 ;
  • b. 文件存在 : 删除原有内容 , 从开头写入内容 ;
• ③ " a " : 打开文件文件 , 只写操作 , 追加写入内容 ;
  • a. 文件不存在 : 创建新文件 , 从开头写入内容 ;
  • b. 文件存在 : 在原有文件基础上 , 追加写入内容 ;

4. 文件打开模式读写操作 :

• ① " r+ " : 打开文本文件 , 读写操作 ;
• ② " w+ " : 打开文本文件 , 读写操作 ; 从开始开始写入内容 ;
  • a. 文件不存在 : 创建新文件 , 从开头写入内容 ;
  • b. 文件存在 : 删除原有内容 , 从开头写入内容 ;
• ③ " a+ " : 打开文本文件 , 读写操作 ; 追加写入内容 ;
  • a. 文件不存在 : 创建新文件 , 从开头写入内容 ;
  • b. 文件存在 : 在原有文件基础上 , 追加写入内容 ;

II C 函数 fprintf 写出文件

---

fprintf 函数简介 :

• ① 头文件 : stdio.h
• ② 函数原型 : int fprintf (FILE* stream, const char*format, [argument])
• ③ 参数 1 ( FILE * stream ) : FILE 指针 , 指向标识文件流的对象 ;
• ④ 参数 2 ( const char * format ) : C 字符串 , 要写出的文本 , 包含占位符 ;
• ⑤ 参数 3 ( [argument] ) : 字符串中的占位符参数列表 ;
• ⑤ 函数作用 : 根据规定的数据格式 , 向输出流中写出数据 ;

代码示例 :

	//1. fprintf 写出文本

	//创建一个只写的文件 , 每次执行都重新写入内容
	//	这里使用相对路径 , 直接在代码路径下创建一个文件
	FILE* file_text_write = fopen("my_file.txt", "w");

	//文本形式写出内容 : 使用格式化的方式输出文本内容
	fprintf(file_text_write, "姓名:%s 学号:%d", "Tom", 1);

	//关闭文件 , 只有有 fopen , 就必须有对应的 fclose 与之对应
	fclose(file_text_write);

III C 函数 fscanf 读取文件 ( 遇到空格换行结束)

---

fscanf 函数简介 :

• ① 头文件 : stdio.h
• ② 函数原型 : int fscanf(FILE * stream, const char * format, [argument...]);
• ③ 参数 1 ( FILE * stream ) : FILE 指针 , 指向标识文件流的对象 ;
• ④ 参数 2 ( const char * format ) : C 字符串 , 声明读取的数据类型 ;
• ⑤ 函数作用 : 根据规定的数据格式 , 从输入流中读取数据 ;

fscanf 与 fgets 函数对比 :

• ① fscanf 遇到空格 , 换行 结束读取 ;
• ② fgets 遇到空格时不结束读取 , 遇到换行时结束 ;

代码示例 :

	//2. fscanf 读取文本
	//以只读形式打开
	FILE* file_text_read_fscanf = fopen("my_file.txt", "r");

	//读取文件
	//定义读取文件文本的缓冲区 , 最大可以读取 1024 个字符
	char buffer[1024];

	//如果没有遇到结尾 , 就一直读取
	while (!feof(file_text_read_fscanf))
	{
		//参数1 : 文件指针 , 参数2 : 占位符 , 参数3 : 接收的缓冲区
		//	该方法遇到空格 , 会中断读取 , 因此这里要循环读取数据
		fscanf(file_text_read_fscanf, "%s", buffer);

		cout << "fscanf 读取到的文本内容 : " << buffer << endl;
	}

	//对应fopen
	fclose(file_text_read_fscanf);

执行结果 : 遇到空格读取就会中断 , 这里循环了 2 次将文件读取完毕 ;

fscanf 读取到的文本内容 : 姓名:Tom
fscanf 读取到的文本内容 : 学号:1

IV C 函数 fgets 读取文件 ( 遇到换行结束)

---

1. fgets 函数简介 :

• ① 头文件 : stdio.h
• ② 函数原型 : char *fgets(char *str, int n, FILE *stream);
• ③ 参数 1 ( char *str ) : 字符指针 , 指向读取文件字符串的缓冲区 ;
• ④ 参数 2 ( int n ) : 缓冲区中可读取的最大字符数 ;
• ⑤ 参数 3 ( FILE *stream ) : FILE 指针 , 指向标识文件流的对象 ;
• ⑤ 函数作用 : 从输入流中读取一行文本数据 , 并将文本存储到字符数组缓冲区中 ;

2. fscanf 与 fgets 函数对比 :

• ① fscanf 遇到空格 , 换行 结束读取 ;
• ② fgets 遇到空格时不结束读取 , 遇到换行时结束 ;

3. 代码示例 :

	//3. fgets 读取指定大小的文本
	//以只读形式打开
	FILE* file_text_read_fgets = fopen("my_file.txt", "r");

	//读取文件
	//定义读取文件文本的缓冲区 , 最大可以读取 1024 个字符
	char buffer1[1024];


	//参数1 : 接收的缓冲区 , 参数2 : 读取的字节数 , 参数3 : 文件指针
	//	该方法遇到空格 , 会继续读取 , 因此这里只需要读取一次即可
	fgets(buffer1, 1024, file_text_read_fgets);

	cout << "fgets 读取到的文本内容 : " << buffer1 << endl;
	
	//对应fopen
	fclose(file_text_read_fgets);

4. 执行结果 :

fgets 读取到的文本内容 : 姓名:Tom 学号:1

V C 函数 fputc 写出单个字符

---

1. fputc 函数简介 :

• ① 头文件 : stdio.h
• ② 函数原型 : int fputc (int c, File *fp)
• ③ 参数 1 ( int c ) : 要写出的字符 ;
• ④ 参数 2 ( File *fp ) : 文件指针 ;
• ⑤ 函数作用 : 向文件中写出一个单个字符 ;
• ⑥ 返回值 : 如果写出成功 , 返回写出字符的 ASCII 值 , 如果写出失败 , 返回 EOF 即 -1 ;

2. 代码示例 :

	//4. 写出单个字符
	FILE* file_text_read_fputc = fopen("my_file.txt", "w");
	//写出单个字符串
	fputc('A', file_text_read_fputc);
	//关闭文件
	fclose(file_text_read_fputc);

VI C 函数 fgetc 读取单个字符

---

1. fgetc 函数简介 :

• ① 头文件 : stdio.h
• ② 函数原型 : int fgetc(FILE *stream)
• ④ 参数 ( File *stream ) : 文件指针 ;
• ⑤ 函数作用 : 从文件流中读取一个字符 ;
• ⑥ 返回值 : 从文件中读取的字符 ASCII 码值 ;

2. 代码示例 :

	//5. 读取单个字符
	FILE* file_text_read_getc = fopen("my_file.txt", "r");
	//读取单个字符串
	int fgetc_result = fgetc(file_text_read_getc);
	//将 int 类型变量转为 char 类型变量
	char fgetc_result_char = fgetc_result;
	cout << "fgetc 读取的单个字符  : " << fgetc_result_char << endl;
	//关闭文件
	fclose(file_text_read_getc);

3. 执行结果 :

fgetc 读取的单个字符  : A

VII C++ IO 流

---

1. C++ 中主要使用以下三个数据类型进行 IO 流操作 ;

• ofstream : 文件输出流 , 向文件写出内容 ( 如果没有文件会创建文件 ) ;
• ifstream : 文件输入流 , 读取文件内容 ;
• fstream : 文件输入输出流 , 兼顾上述两种输入输出流的功能 ;

2. 创建输出流 ofstream : 直接声明 ofstream 对象即可 ;

	//创建 io 输出流
	ofstream io_out_file_stream;

3. 打开文件输出流 : 调用 ofstream 对象的 open() 方法 , 即可打开文件的输出流 , 可以用于向文件中写入数据 ;

	//使用 io_out_file_stream 打开或创建文件
	io_out_file_stream.open("io_file.txt");

4. 从命令行读取数据 : 使用 cin >> io_buffer; 指令 , 可以阻塞命令行 , 等待用户输入文本信息 ; io_buffer 是一个 char 数组缓冲区 ;

	//该操作会阻塞命令行 , 等待用户输入文本信息
	cin >> io_buffer;

5. 向文件中写出数据 : io_out_file_stream << io_buffer << endl; , 向 io_out_file_stream 输出流中写入数据 , 即将缓冲区中的内容写出到了文件中 ;

	// 向文件写入用户输入的数据
	io_out_file_stream << io_buffer << endl;

6. 创建输入流 : 声明 ifstream 类型对象 , 即创建了一个文件输入流对象 ;

	//打开输入流
	ifstream io_in_file_stream;

7. 打开文件输入流 : 调用 ifstream 文件输入流对象的 open 方法 , 即可获取指定路径文件的输入流 ;

	//打开文件
	io_in_file_stream.open("io_file.txt");

8. 读取文件中的内容 : 调用 io_in_file_stream >> io_buffer; , 可以将文件内容读取到 io_buffer 缓冲区中 ;

	//将文件内容读取到缓冲区中
	io_in_file_stream >> io_buffer;

9. 代码示例 :

	//7. C++ 流操作
	
	// ( 1 ) 写出数据到文件

	//创建缓冲区
	char io_buffer[100];
	//创建 io 输出流
	ofstream io_out_file_stream;
	//使用 io_out_file_stream 打开或创建文件
	io_out_file_stream.open("io_file.txt");

	//命令行中进行提示
	cout << "输入你的名字: ";
	//该操作会阻塞命令行 , 等待用户输入文本信息
	cin >> io_buffer;
	
	// 向文件写入用户输入的数据
	io_out_file_stream << io_buffer << endl;
	
	//关闭输出流
	io_out_file_stream.close();

	// ( 2 ) 从文件读取数据

	//打开输入流
	ifstream io_in_file_stream;
	//打开文件
	io_in_file_stream.open("io_file.txt");

	cout << "读取文件" << endl;

	//将文件内容读取到缓冲区中
	io_in_file_stream >> io_buffer;

	//将缓冲区中内容打印到控制台
	cout << "读取的文件内容 : " << io_buffer << endl;

	// 关闭
	io_in_file_stream.close();

10. 执行结果 :

输入你的名字: 1
读取文件
读取的文件内容 : 1

VIII 文件操作代码示例

---

代码调用示例 :

	// XI . IO流

	//1. fprintf 写出文本

	//创建一个只写的文件 , 每次执行都重新写入内容
	//	这里使用相对路径 , 直接在代码路径下创建一个文件
	FILE* file_text_write = fopen("my_file.txt", "w");

	//文本形式写出内容 : 使用格式化的方式输出文本内容
	fprintf(file_text_write, "姓名:%s 学号:%d", "Tom", 1);

	//关闭文件 , 只有有 fopen , 就必须有对应的 fclose 与之对应
	fclose(file_text_write);


	//2. fscanf 读取文本
	//以只读形式打开
	FILE* file_text_read_fscanf = fopen("my_file.txt", "r");

	//读取文件
	//定义读取文件文本的缓冲区 , 最大可以读取 1024 个字符
	char buffer[1024];

	//如果没有遇到结尾 , 就一直读取
	while (!feof(file_text_read_fscanf))
	{
		//参数1 : 文件指针 , 参数2 : 占位符 , 参数3 : 接收的缓冲区
		//	该方法遇到空格 , 会中断读取 , 因此这里要循环读取数据
		fscanf(file_text_read_fscanf, "%s", buffer);

		cout << "fscanf 读取到的文本内容 : " << buffer << endl;
	}

	//对应fopen
	fclose(file_text_read_fscanf);


	//3. fgets 读取指定大小的文本
	//以只读形式打开
	FILE* file_text_read_fgets = fopen("my_file.txt", "r");

	//读取文件
	//定义读取文件文本的缓冲区 , 最大可以读取 1024 个字符
	char buffer1[1024];


	//参数1 : 接收的缓冲区 , 参数2 : 读取的字节数 , 参数3 : 文件指针
	//	该方法遇到空格 , 会继续读取 , 因此这里只需要读取一次即可
	fgets(buffer1, 1024, file_text_read_fgets);

	cout << "fgets 读取到的文本内容 : " << buffer1 << endl;
	
	//对应fopen
	fclose(file_text_read_fgets);


	//4. 写出单个字符
	FILE* file_text_read_fputc = fopen("my_file.txt", "w");
	//写出单个字符串
	fputc('A', file_text_read_fputc);
	//关闭文件
	fclose(file_text_read_fputc);

	//5. 读取单个字符
	FILE* file_text_read_getc = fopen("my_file.txt", "r");
	//读取单个字符串
	int fgetc_result = fgetc(file_text_read_getc);
	//将 int 类型变量转为 char 类型变量
	char fgetc_result_char = fgetc_result;
	cout << "fgetc 读取的单个字符  : " << fgetc_result_char << endl;
	//关闭文件
	fclose(file_text_read_getc);


	//6. 读写二进制文件 使用 fwrite 与 fread 读写文件


	//7. C++ 流操作
	
	// ( 1 ) 写出数据到文件

	//创建缓冲区
	char io_buffer[100];
	//创建 io 输出流
	ofstream io_out_file_stream;
	//使用 io_out_file_stream 打开或创建文件
	io_out_file_stream.open("io_file.txt");

	//命令行中进行提示
	cout << "输入你的名字: ";
	//该操作会阻塞命令行 , 等待用户输入文本信息
	cin >> io_buffer;
	
	// 向文件写入用户输入的数据
	io_out_file_stream << io_buffer << endl;
	
	//关闭输出流
	io_out_file_stream.close();

	// ( 2 ) 从文件读取数据

	//打开输入流
	ifstream io_in_file_stream;
	//打开文件
	io_in_file_stream.open("io_file.txt");

	cout << "读取文件" << endl;

	//将文件内容读取到缓冲区中
	io_in_file_stream >> io_buffer;

	//将缓冲区中内容打印到控制台
	cout << "读取的文件内容 : " << io_buffer << endl;

	// 关闭
	io_in_file_stream.close();

执行结果 :

fscanf 读取到的文本内容 : 姓名:Tom
fscanf 读取到的文本内容 : 学号:1
fgets 读取到的文本内容 : 姓名:Tom 学号:1
fgetc 读取的单个字符  : A
输入你的名字: 1
读取文件
读取的文件内容 : 1