fwrite

来自cppreference.com
< c‎ | io
 
 
文件输入/输出
类型与对象
函数
文件访问
直接输入/输出
fwrite
无格式输入/输出
(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 向输出流 stream 写入 count 个对象。各个对象的写入,如同将每个对象解读为 unsigned char 数组,并对每个对象调用 sizefputc 以将那些 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 The fwrite function (第 TBD 页)
  • C17 标准(ISO/IEC 9899:2018):
  • 7.21.8.2 The fwrite function (第 TBD 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 7.21.8.2 The fwrite function (第 335-336 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.19.8.2 The fwrite function (第 301-302 页)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 4.9.8.2 The fwrite function

参阅

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