Namespaces
Variants

fwrite

From cppreference.net
< 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起)

将给定数组 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 函数 (页: TBD)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.21.8.2 fwrite 函数 (p: 335-336)
  • C99标准(ISO/IEC 9899:1999):
  • 7.19.8.2 fwrite函数(页码:301-302)
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 4.9.8.2 fwrite 函数

参见

将格式化输出打印到 stdout 、文件流或缓冲区
(函数)
将字符串写入文件流
(函数)
从文件读取
(函数)
C++ 文档 关于 fwrite