fread

ブロック単位でファイルを読み込みます．主にバイナリファイル (binary file) を読み込む場合に使用します． 

#include <stdio.h>

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

fread 関数は stream が指すストリーム (stream) から，size バイト単位で nmemb 個のデータを読み込み，ptr が指す配列に格納します．

引数

  • ptr: 読み込む領域へのポインタ
  • size: 要素 1 個あたりの大きさ
  • nmemb: 要素の個数
  • stream: ストリーム

戻り値

  • 読み取り成功時: 読み取った要素の個数 (バイト数ではない)
  • size または nmembが 0 : 0

C言語サンプルプログラム

以下に fread 関数を使用してファイルから文字列を読み込むサンプルプログラムを示します．

/* header files */
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

/* macros */
#define N 256

/* structures */
typedef struct player_tag {
    char no[N];
    char name[N];
    char team[N];
} player;

/* main */
int main(void) {
    int i;
    FILE *fp;
    char *filename = "sample.dat";
    player p[2];

    /* ファイルのオープン */
    if ((fp = fopen(filename, "rb")) == NULL) {
        fprintf(stderr, "%sのオープンに失敗: %s\n",
                filename, strerror(errno));
        return EXIT_FAILURE;
    }

    for ( i = 0; i < 2; i++ ) {
        fread(&p[i].no, 1 ,4 ,fp);
        p[i].no[4] = '\0';

        fread(&p[i].name, 1 ,14 ,fp);
        p[i].name[14] = '\0';

        fread(&p[i].team, 1 ,10 ,fp);
        p[i].team[10] = '\0';
    }

    for ( i = 0; i < 2; i++ ) {
        printf("%s, %s, %s\n", p[i].no, p[i].name, p[i].team);
    }

    /* ファイルのクローズ */
    fclose(fp);

    return EXIT_SUCCESS;
}

sample.datの内容

sample.dat を以下のように用意したとします．

0051ススキヒチローマリナーズ0055マツイヒテキ  ヤンキース

実行例

サンプルプログラムの実行結果は以下のようになります．

0051, ススキヒチロー, マリナーズ
0055, マツイヒテキ  , ヤンキース

cプログラマの必読書

たくさんあるc言語関連の書籍の中でも特に役に立った本です．よかったら参考にしてみてください．

c実践プログラミング 第3版

c言語の実践的参考書．少々値段は張りますが初心者を脱しようとしている人は絶対に読むべきです．
文法だけでなく，コーディングスタイルやデバッグなど文字通り「実践的」なことが書かれているので非常にためになります． オライリーの本は，読みにくい本が多いのですが本書はとても読みやすくオススメです．


c言語ポインタ完全制覇 (標準プログラマーズライブラリ)

ポインタの解説書としては最高の書籍です．
この1冊でポインタを完全に理解することができます．全くの初学者が読むには敷居が高いですが，入門書を読み終えた後に読むと非常に有益です．