# fwrite

< c‎ | io

定义于头文件 `<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

### 参阅

printf fprintf sprintf snprintf printf_s fprintf_s sprintf_s snprintf_s (C99)(C11)(C11)(C11)(C11) | 打印格式化输出到 stdout 、文件流或缓冲区 (函数)
fputs | 将一个字符串写入文件流 (函数)
fread | 从文件读取 (函数)