标准 I/O 库函数：fopen()、fwrite()、fread()、fclose()详解

        fopen()、fwrite()、fread()、fclose()等函数属于标准 I/O 库函数，调用这些函数需要包含头文件<stdio.h>。这些函数都是构建于文件 I/O（open()、read()、write()、lseek()、close()等）这些系统调用之上的。

目录

一、函数fopen()：打开文件

二、函数fwrite()：写文件

三、函数fread()：读文件

四、函数fclose()：关闭文件

五、代码示例（C语言实现）

---

一、函数fopen()：打开文件

        1.函数原型：

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

        2.函数参数和返回值：

        path：指向文件路径（绝对路径，或者相对路径）。 mode：文件的读写权限，是一个字符串。

        返回值：调用成功返回一个指向 FILE 类型对象的指针，该指针与打开或创建的文件相关联；如果失败则返回 NULL，并设置 errno 以指示错误原因。

        参数mode取值范围：

mode	说明
r	以只读方式打开文件
r+	以可读、可写方式打开文件
w	以只写方式打开文件，如果参数path 指定的文件存在，将文件长度截断为0；如果指定文件不存在 则创建该文件
w+	以可读、可写方式打开文件，如果参数 path 指定 的文件存在，将文件长度截断为 0；如果指定文件不存在则创建该文件
a	以只写方式打开文件，打开以进行追加内容（在 文件末尾写入），如果文件不存在则创建该文件
a+	以可读、可写方式打开文件，以追加方式写入（在文件末尾写入），如果文件不存在则创建该文件

二、函数fwrite()：写文件

        1.函数原型：

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

        2.函数参数和返回值：

        ptr：待写入数据的缓冲区。size：每个数据项的字节大小，与 fread()函数的 size 参数意义相同。nmemb：写入的数据项个数，与 fread()函数的 nmemb 参数意义相同。stream：FILE 指针。

        返回值：成功时，返回写入的数据项的数目（数据项数目并不等于实际写入的字节数，除非参数 size等于 1）；错误时，返回值小于参数 nmemb（或者等于 0）。

三、函数fread()：读文件

        1.函数原型：

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

        2.函数参数和返回值：

        ptr：存放读取数据的缓冲区。size：每个数据项的字节大小。nmemb：参数 nmemb 指定了读取数据项的个数。 stream：FILE 指针。

        返回值：成功时，返回读到的数据项的数目（数据项数目并不等于实际读取的字节数，除非参数 size 等于 1）；错误或到达文件末尾时，返回值将小于参数 nmemb。

        fread()不能区分文件结尾和错误，需要使用 ferror()或 feof() 函数来判断。

四、函数fclose()：关闭文件

        1.函数原型：

int fclose(FILE *stream);

        2.函数参数和返回值：

        stream：FILE类型指针。返回值：成功返回0；失败返回EOF（即：-1），并设置errno以指示错误原因。

五、代码示例（C语言实现）

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

#define SUCCESS							0
#define FAILURE							(-1)
#define TEST_FWRITE_INT_SIZE			16

/*打印封装*/
void formula_printf(char* printfBuf, int printLen, int changeLineLen)
{
	for(int i=0; i<printLen; i++)
	{
		printf("0x%02x, ", printfBuf[i]);
		if(0 == (i + 1)%changeLineLen)
			printf("\n");
	}
	printf("\n");
}

int test_fwrite(void)
{
	FILE *fp = NULL;
	char testStr[] = "Hello World!";//字符串长度12（不算'\0'）
	int testInt[TEST_FWRITE_INT_SIZE] = {0};
 
 /*打开文件*/
	if (NULL == (fp = fopen("./test_file", "w+"))) //w+：可读可写，文件不存在就创建
	{
		printf("fopen error\n");
		return FAILURE;
	}
	printf("fopen succ\n");

/*写入文件*/
	//写入字符串
	if (sizeof(testStr) > fwrite(testStr, 1, sizeof(testStr), fp)) //成功时，返回写入的数据项的数目；错误时，返回值小于参数 nmemb（或等于 0）。
	{
		printf("fwrite str error\n");
		fclose(fp);
		return FAILURE;
	}
	printf("sizeof(testStr) = %lu\n", sizeof(testStr));
	printf("fwrite str succ\n");
#if 1
	//写入int型数字
	memset((char*)testInt, 0x21, 16);//单位：1字节
	memset((char*)&testInt[8], 0x31, 8*sizeof(int));
	printf("sizeof(testInt) = %lu\n", sizeof(testInt));//sizeof计算出的长度，单位：1字节
	if (TEST_FWRITE_INT_SIZE > fwrite(testInt, sizeof(int), TEST_FWRITE_INT_SIZE, fp))
	{
		printf("fwrite int error\n");
		fclose(fp);
		return FAILURE;
	}
	printf("fwrite int succ\n");
#endif
/*关闭文件*/
	fclose(fp);
	return SUCCESS;
}

int test_fread(void)
{
	FILE *fp = NULL;
	char buf[128] = {0};
	int size = 0;
 
 /*打开文件*/
	if (NULL == (fp = fopen("./test_file", "r"))) //r：以只读方式打开文件
	{
		printf("fopen error\n");
		return FAILURE;
	}
	printf("fopen succ\n");

/*读文件*/
	if (sizeof(buf) > (size = fread(buf, 1, sizeof(buf), fp))) 
	{
		if (ferror(fp))//使用 ferror 判断是否是发生错误
		{ 
			printf("fread error\n");
			fclose(fp);
			return FAILURE;
		}
	//如果未发生错误，说明已经到达了文件末尾
	}
	printf("fread size: %d\n", size);
	printf("fread result: %s\n", buf);
	formula_printf(buf, sizeof(buf), 16);
/*关闭文件*/
	fclose(fp);
	return SUCCESS;
}

int main(void)
{
	int ret = 0;
	printf("test_fwrite start\n");
	ret = test_fwrite();
	if(FAILURE == ret)
	{
		return FAILURE;
	}
	
	printf("\ntest_fread start\n");
	ret = test_fread();
	if(FAILURE == ret)
	{
		return FAILURE;
	}
	return SUCCESS;
}

2. 执行结果：

  3. 结果分析

sizeof(testStr) = 13：字符串末尾有‘\0’

fread size: 77：写入文件的总长度是77，所以只能读出77字节。即：字符串长度13 + 64字节长度。