fread

指定された入力ストリーム stream から、最大 count 個のオブジェクトを配列 buffer に読み込む。各オブジェクトに対して size 回の fgetc 呼び出しと同様の方法で読み取り、取得した順序で buffer の連続する位置に格納する。 buffer は unsigned char の配列として再解釈される。ストリームのファイル位置指示子は、読み取られた文字数分だけ進められる。

エラーが発生した場合、ストリームのファイル位置指示子の結果の値は不定です。部分的な要素が読み込まれた場合、その値は不定です。

パラメータ

戻り値

正常に読み込まれたオブジェクトの数。エラーまたはEOF（end-of-file）状態が発生した場合、 count より少なくなる可能性があります。

size または count がゼロの場合、 fread はゼロを返し、それ以外の処理は実行しません。

fread はEOF（ファイル終端）とエラーを区別せず、呼び出し元は feof と ferror を使用してどちらが発生したかを判定する必要があります。

例

#include <stdio.h>
enum { SIZE = 5 };
int main(void)
{
    const double a[SIZE] = {1.0, 2.0, 3.0, 4.0, 5.0};
    printf("Array has size %ld bytes, element size: %ld\n", sizeof a, sizeof *a);
    FILE *fp = fopen("test.bin", "wb"); // must use binary mode
    fwrite(a, sizeof *a, SIZE, fp); // writes an array of doubles
    fclose(fp);
    double b[SIZE];
    fp = fopen("test.bin","rb");
    const size_t ret_code = fread(b, sizeof b[0], SIZE, fp); // reads an array of doubles
    if (ret_code == SIZE)
    {
        printf("Array at %p read successfully, contents:\n", (void*)&a);
        for (int n = 0; n != SIZE; ++n)
            printf("%f ", b[n]);
        putchar('\n');
    }
    else // error handling
    {
        if (feof(fp))
            printf("Error reading test.bin: unexpected end of file\n");
        else if (ferror(fp))
            perror("Error reading test.bin");
    }
    fclose(fp);
}

Array has size 40 bytes, element size: 8
Array at 0x1337f00d6960 read successfully, contents:
1.000000 2.000000 3.000000 4.000000 5.000000

参考文献

関連項目