命名空间
变体
操作

fwrite

来自 cppreference.cn
< c‎ | io
 
 
文件输入/输出
类型和对象
        
函数
文件访问
(C95)
无格式输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)

格式化输入
 
定义于头文件 <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

如果 sizecount 为零,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 函数

[编辑] 参见

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