C语言fwrite函数详解(参数说明、用法、例子)

在C语言编程中，fwrite 函数是一个非常实用且功能强大的工具，主要用于将数据从内存写入到文件中。无论是在处理文本文件还是二进制文件时，fwrite 都能发挥重要作用。本文将详细介绍 fwrite 函数的参数说明、用法以及一些具体的示例，帮助读者更好地理解和掌握这一函数。

一、fwrite 函数的基本介绍

1. 定义与原型

fwrite 是标准C库提供的一个函数，用于将一块内存中的数据写入到文件流中。其函数原型如下：

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

ptr：指向要写入的数据块的指针。

size：每个数据项的大小（以字节为单位）。

nmemb：要写入的数据项数量。

stream：指向目标文件流的指针。

返回值：成功写入的数据项数量，若发生错误则返回小于 nmemb 的值。

1. 参数详解

ptr：这是指向数据块的指针，数据块可以是数组、结构体或其他类型的变量。fwrite 会从该指针开始读取数据并写入文件。

size：表示每个数据项的大小。例如，如果 size 为 4，则意味着每次写入 4 个字节的数据。对于整型变量，通常设置为 sizeof(int)。

nmemb：表示要写入的数据项数量。例如，如果 nmemb 为 10，则意味着总共要写入 10 个数据项。

stream：这是一个指向 FILE 类型的指针，表示目标文件流。在调用 fwrite 之前，必须先打开文件并获取其文件流。

二、fwrite 函数的用法

1. 打开文件

在使用 fwrite 之前，需要先打开文件并获取其文件流。可以使用 fopen 函数来打开文件，具体用法如下：

FILE *fp = fopen("filename.txt", "wb");

"filename.txt"：目标文件的名称。

"wb"：以二进制写模式打开文件。如果是文本文件，可以使用 "w"。

1. 写入数据

一旦文件流被成功打开，就可以使用 fwrite 将数据写入文件。例如：

int data[] = {1, 2, 3, 4, 5};
size_t count = fwrite(data, sizeof(int), 5, fp);

data：指向整型数组的指针。

sizeof(int)：每个整型数据的大小为 4 字节。

5：要写入的数据项数量。

fp：指向文件流的指针。

1. 关闭文件

完成数据写入后，记得关闭文件以释放资源：

fclose(fp);

三、fwrite 函数的示例

1. 示例 1：写入整型数组

以下是一个简单的示例，演示如何使用 fwrite 将整型数组写入文件：

#include <stdio.h>
int main() {
    int data[] = {10, 20, 30, 40, 50};
    size_t count;
    // 打开文件
    FILE *fp = fopen("output.bin", "wb");
    if (fp == NULL) {
        printf("无法打开文件\n");
        return 1;
    }
    // 写入数据
    count = fwrite(data, sizeof(int), 5, fp);
    if (count != 5) {
        printf("写入失败\n");
    } else {
        printf("成功写入 %zu 个数据项\n", count);
    }
    // 关闭文件
    fclose(fp);
    return 0;
}

1. 示例 2：写入结构体数组
   

假设我们有一个结构体 Person，我们可以使用 fwrite 将多个结构体对象写入文件：

#include <stdio.h>
#include <stdlib.h>
typedef struct {
    char name[20];
    int age;
} Person;
int main() {
    Person people[] = {
        {"Alice", 25},
        {"Bob", 30},
        {"Charlie", 35}
    };
    size_t count;
    // 打开文件
    FILE *fp = fopen("people.dat", "wb");
    if (fp == NULL) {
        printf("无法打开文件\n");
        return 1;
    }
    // 写入数据
    count = fwrite(people, sizeof(Person), 3, fp);
    if (count != 3) {
        printf("写入失败\n");
    } else {
        printf("成功写入 %zu 个结构体\n", count);
    }
    // 关闭文件
    fclose(fp);
    return 0;
}

1. 示例 3：写入字符串
   

fwrite 不仅可以写入二进制数据，还可以写入字符串。例如：

#include <stdio.h>
int main() {
    const char str[] = "Hello, World!";
    size_t count;
    // 打开文件
    FILE *fp = fopen("output.txt", "w");
    if (fp == NULL) {
        printf("无法打开文件\n");
        return 1;
    }
    // 写入字符串
    count = fwrite(str, sizeof(char), sizeof(str) - 1, fp);
    if (count != sizeof(str) - 1) {
        printf("写入失败\n");
    } else {
        printf("成功写入 %zu 个字符\n", count);
    }
    // 关闭文件
    fclose(fp);
    return 0;
}

四、fwrite 函数的注意事项

1. 错误处理

在使用 fwrite 时，应该检查返回值是否等于预期的数量。如果返回值小于预期，说明写入操作可能失败，需要进一步排查原因。

1. 文件模式

确保在打开文件时选择正确的模式。如果是二进制文件，应使用 "wb" 模式；如果是文本文件，可以使用 "w" 模式。

1. 文件流状态

在写入数据之前，确保文件流处于正常状态。如果文件流已经被关闭或处于不可写的状态，fwrite 将无法正常工作。

1. 内存管理

在使用 fwrite 时，确保传入的指针指向有效的内存区域。如果指针为空或指向无效内存，会导致未定义行为。

1. 文件大小限制

fwrite 的返回值是 size_t 类型，因此在处理大文件时需要注意溢出问题。

fwrite 是C语言中一个非常有用的函数，它能够高效地将数据从内存写入到文件中。通过本文的详细介绍，读者应该已经掌握了 fwrite 的基本用法及其参数含义。无论是处理简单的整型数组还是复杂的结构体数据，fwrite 都能胜任。希望本文的内容能够帮助读者更好地理解和应用这一函数，从而在实际开发中发挥更大的作用。未来，随着编程技术的不断发展，fwrite 也将继续为我们提供强大的支持。

声明：所有来源为“聚合数据”的内容信息，未经本网许可，不得转载！如对内容有异议或投诉，请与我们联系。邮箱：marketing@think-land.com