fwrite

定义在头文件 `<stdio.h>` 中
size_t fwrite( const void* buffer, size_t size, size_t count, FILE* stream );		(直到 C99)
size_t fwrite( const void* restrict buffer, size_t size, size_t count, FILE* restrict stream );		(自 C99 起)

将给定数组 buffer 中的 count 个对象写入输出流 stream。这些对象被写入，就好像通过将每个对象重新解释为一个 unsigned char 数组并对每个对象调用 fputc size 次来将这些 unsigned char 写入 stream，按顺序进行。流的文件位置指示器将根据写入的字符数进行递进。

如果发生错误，流的文件位置指示器的结果值是不确定的。

[编辑] 参数

buffer	-	指向要写入的数组中的第一个对象的指针
size	-	每个对象的尺寸
count	-	要写入的对象数量
stream	-	指向输出流的指针

[编辑] 返回值

成功写入的对象数量，如果发生错误，可能小于 count。

如果 size 或 count 为零，fwrite 将返回零，并且不会执行其他任何操作。

[编辑] 示例

运行此代码

#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
 
enum { SIZE = 5 };
 
int main(void)
{
    double a[SIZE] = {1, 2, 3, 4, 5};
    FILE* f1 = fopen("file.bin", "wb");
    assert(f1);
    size_t r1 = fwrite(a, sizeof a[0], SIZE, f1);
    printf("wrote %zu elements out of %d requested\n", r1, SIZE);
    fclose(f1);
 
    double b[SIZE];
    FILE* f2 = fopen("file.bin", "rb");
    size_t r2 = fread(b, sizeof b[0], SIZE, f2);
    fclose(f2);
    printf("read back: ");
    for (size_t i = 0; i < r2; ++i)
        printf("%0.2f ", b[i]);
}

输出

wrote 5 elements out of 5 requested
read back: 1.00 2.00 3.00 4.00 5.00

[编辑] 参考文献

C23 标准 (ISO/IEC 9899:2024)

7.21.8.2 fwrite 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.21.8.2 fwrite 函数 (p: TBD)

C11 标准 (ISO/IEC 9899:2011)

7.21.8.2 fwrite 函数 (p: 335-336)

C99 标准 (ISO/IEC 9899:1999)

7.19.8.2 fwrite 函数 (p: 301-302)

C89/C90 标准 (ISO/IEC 9899:1990)

4.9.8.2 fwrite 函数

[编辑] 另请参阅

printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11)	将格式化输出打印到 stdout、文件流或缓冲区 (函数) [编辑]
fputs	将字符字符串写入文件流 (函数) [编辑]
fread	从文件中读取 (函数) [编辑]
C++ 文档用于 fwrite

编译器支持
语言
头文件
类型支持
程序实用程序
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用程序
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.com

命名空间

变体

视图

操作