C++のfread()関数の使い方を徹底解説！パラメータとサンプルコード付き

fread()関数とは

C/C++の標準ライブラリ関数であるsize_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream)は、指定されたストリームからデータを読み込み、ptrが指す配列に格納します。テキストファイルだけでなく、構造体や配列などのバイナリデータを読み込む際に特に便利な関数です。

fread()関数の宣言は以下の通りです。

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

パラメータの詳細

fread()関数が受け取る各パラメータの説明は以下の表の通りです。

戻り値について

正常に読み込まれた要素の総数が、整数型のsize_tオブジェクトとして返されます。この戻り値がnmembパラメータと異なる場合、エラーが発生したか、ファイルの終端（EOF）に達したことを意味します。どちらの状況かを判別するには、ferror()関数やfeof()関数を組み合わせて使用すると良いでしょう。

サンプルコード

#include <stdio.h>
#include <string.h>
int main () {
   FILE *fp;
   char c[] = "this is tutorialspoint";
   char buffer[100];
   /* 読み書き両用でファイルを開く */
   fp = fopen("file.txt", "w+");
   /* ファイルにデータを書き込む */
   fwrite(c, strlen(c) + 1, 1, fp);
   /* ファイルの先頭にシークする */
   fseek(fp, 0, SEEK_SET);
   /* データを読み込んで表示する */
   fread(buffer, strlen(c)+1, 1, fp);
   printf("%s\n", buffer);
   fclose(fp);
   return(0);
}

上記のプログラムをコンパイルして実行すると、file.txtというファイルが作成され、「this is tutorialspoint」という内容が書き込まれます。その後、fseek()関数を使ってファイルポインタを先頭に戻し、書き込んだ内容をfread()関数で読み込んで表示します。

実行結果

this is tutorialspoint

このように、fread()関数を使えば、ファイルから指定したサイズのデータをまとめて効率的に読み込むことができます。fwrite()関数と組み合わせることで、ファイルへの書き込みと読み込みを柔軟に制御できるため、バイナリファイルを扱うプログラムで広く活用されています。