fread

[機能]

　　ストリームからデータを読み込みます．fscanf 関数との違いは，データを編集して読み込まず，そのままのイメージで読み込む点です．実際に読み込んだデータの数を返します．読込時のエラーやファイルの終端を検出するためには，ferror 関数や feof 関数を使用しなければなりません．

[形式]

#include <stdio.h>

size_t fread(void *buffer, size_t size, size_t count, FILE *stream)
	buffer : 読み込んだデータの格納場所
	size   : 各データの大きさ（バイト単位）
	count  : 読み込まれる最大データ数
	stream : FILE 構造体へのポインタ		

[使用例]

1. ファイルの終端か否か，入力エラーがあるか無いかを調べながら読み込みます

   #include <stdio.h>
   #include <stdlib.h>
   
   int main()
   {
   	int count, total, i1;
   	long li[5], lo[5];
   	FILE *stream;
   /*
   		 データの設定
   */
   	for (i1 = 0; i1 < 5; i1++)
   		lo[i1] = i1 + 1;
   /*
   		 ファイルのオープン（出力）
   */
   	if((stream = fopen("data", "w")) == NULL)
   		exit(1);
   /*
   		 ファイルへのデータの出力とファイルのクローズ
   */
   	count = fwrite(lo, sizeof(long), 5, stream);
   	printf("%d 個のデータを出力しました\n", count);
   	fclose(stream);
   /*
   		 ファイルのオープン（入力）
   */
   	if((stream = fopen("data", "r")) == NULL)
   		exit(1);
   /*
   		 データの読込
   */
   	total = 0;
   	i1    = 0;
   	while (!feof(stream)) {
   		count = fread(&(li[i1]), sizeof(long), 1, stream);
   		if (ferror(stream)) {
   			perror("***入力エラー***");
   			exit(1);
   		}
   		total += count;
   		i1++;
   	}
   	printf("%d 個のデータを入力しました\n", total);
   	for (i1 = 0; i1 < 5; i1++)
   		printf("%ld ", li[i1]);
   	printf("\n");
   
   	return 0;
   }
   			

   （出力）

   5 個のデータを出力しました
   5 個のデータを入力しました
   1 2 3 4 5 			

[参照]

ferror,　feof,　fwrite,　fscanf,　read,　write