fwrite
来自cppreference.com
在标头 <stdio.h> 定义
|
||
(C99 前) | ||
(C99 起) | ||
从给定数组 buffer 向输出流 stream 写入 count 个对象。各个对象的写入,如同将每个对象解读为 unsigned char 数组,并对每个对象调用 size 次 fputc 以将那些 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 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
参阅
(C99)(C11)(C11)(C11)(C11) |
打印格式化输出到 stdout 、文件流或缓冲区 (函数) |
将一个字符串写入文件流 (函数) | |
从文件读取 (函数) |