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 起)

写 count 个来自给定数组 buffer 的对象到输出流stream。如同转译每个对象为 unsigned char 数组，并对每个对象调用 size 次 fputc 以将那些 unsigned char 按顺序写入 stream 一般写入。文件位置指示器前进写入的字节数。

参数

buffer	-	指向数组中要被写入的首个对象的指针
size	-	每个对象的大小
count	-	要被写入的对象数
stream	-	指向输出流的指针

返回值

成功写入的对象数，若错误发生则可能小于 count 。

若 size 或 count 为零，则 fwrite 返回零并不进行其他行动。

示例

运行此代码

#include <stdio.h>
#include <stdlib.h>
#include <assert.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

引用

C11 标准（ISO/IEC 9899:2011）：

7.21.8.2 The fwrite function (p: 335-336)

C99 标准（ISO/IEC 9899:1999）：

7.19.8.2 The fwrite function (p: 301-302)

C89/C90 标准（ISO/IEC 9899:1990）：

4.9.8.2 The fwrite function

参阅

printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11)	打印格式化输出到 stdout 、文件流或缓冲区 (函数)
fputs	将一个字符串写入文件流 (函数)
fread	从文件读取 (函数)

语言
头文件
类型支持
程序工具
变参数函数支持
动态内存管理
错误处理
日期和时间工具
字符串库
算法
数值
输入/输出支持
本地化支持
线程支持 (C11)
原子操作 (C11)
技术规范

fwrite

参数

返回值

示例

引用

参阅

导航