fwrite

指定された配列 buffer から count 個のオブジェクトを出力ストリーム stream に書き込みます。各オブジェクトは unsigned char の配列として再解釈され、 fputc が各オブジェクトに対して size 回呼び出されることで、これらの unsigned char が順番に 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

参考文献

関連項目