先頭へ戻る

fread | Programming Place Plus C言語編 標準ライブラリのリファレンス

Programming Place Plus トップページ -- C言語編 -- 標準ライブラリのリファレンス(名前順)

Programming Place Plus トップページ -- C言語編 -- 標準ライブラリのリファレンス(ヘッダ別)

先頭へ戻る

fread関数

概要

入力ストリームから、任意の大きさの要素を任意の個数だけ読み取る。

ヘッダ

stdio.h

形式

size_t fread(void* ptr, size_t size, size_t n, FILE* stream);

引数

ptr

読み取ったデータを受け取る配列を指すポインタ。

size

要素1個の大きさ。

n

要素数。

stream

入力ストリーム。

戻り値

実際に読み込まれた要素数。
エラーが発生したり、ファイルの末尾まで到達したりした際には、引数n よりも小さい値が返される。引数size や n に 0 を指定した場合には、何も起こらず、0 が返される。

詳細

引数 n の個数分だけ、大きさが引数 size の要素を読み取る。

注意

使用例

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    FILE* fp;
    int num;
    double d;
    char str[7];


    fp = fopen( "test.bin", "rb" );
    if( fp == NULL ){
        fputs( "ファイルオープンに失敗しました。\n", stderr );
        exit( EXIT_FAILURE );
    }

    if( fread( &num, sizeof(num), 1, fp ) < 1 ){
        fputs( "読み込み中にエラーが発生しました。\n", stderr );
        exit( EXIT_FAILURE );
    }
    if( fread( &d, sizeof(d), 1, fp ) < 1 ){
        fputs( "読み込み中にエラーが発生しました。\n", stderr );
        exit( EXIT_FAILURE );
    }
    if( fread( str, sizeof(str[0]), sizeof(str), fp ) < sizeof(str) ){
        fputs( "読み込み中にエラーが発生しました。\n", stderr );
        exit( EXIT_FAILURE );
    }

    printf( "%d\n", num );
    printf( "%f\n", d );
    printf( "%s\n", str );

    if( fclose( fp ) == EOF ){
        fputs( "ファイルクローズに失敗しました。\n", stderr );
        exit( EXIT_FAILURE );
    }

    return 0;
}

実行結果(標準出力)

900
7.850000
xyzxyz

関連

書き込みには fwrite関数を用いる。

解説章

第42章


参考リンク


------------------------------------------------------------------------

更新履歴

'2018/4/8 全体的に文章を見直し修正。

'2018/2/22 「サイズ」という表記について表現を統一。 型のサイズ(バイト数)を表しているところは「大きさ」、要素数を表しているところは「要素数」。

'2018/1/22 新規作成。


------------------------------------------------------------------------

標準ライブラリのリファレンス(名前順)のトップページへ

標準ライブラリのリファレンス(ヘッダ別)のトップページへ

C言語編のトップページへ

Programming Place Plus のトップページへ



はてなブックマーク に保存 Pocket に保存 Facebook でシェア
Twitter でツイート Twitter をフォロー LINE で送る
rss1.0 取得ボタン RSS 管理者情報 プライバシーポリシー