fwrite
来自 zh.cppreference.net
| 定义于头文件 <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 数组，并对每个对象调用 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 函数 (p: TBD)
- C11 标准 (ISO/IEC 9899:2011):
- 7.21.8.2 fwrite 函数 (p: 335-336)
- C99 标准 (ISO/IEC 9899:1999):
- 7.21.8.2 fwrite 函数 (p: 301-302)
- C89/C90 标准 (ISO/IEC 9899:1990):
- 4.9.8.2 fwrite 函数
参阅
(C99)(C11)(C11)(C11)(C11) |
将格式化输出打印到 stdout、文件流或缓冲区 (函数) |
| 将一个字符串写入文件流 (函数) | |
| 从文件读取 (函数) | |
C++ 文档 关于 fwrite
| |