C言語の標準ライブラリfreadのリファレンスです。
概要 | ブロック単位でファイルを読込む。 |
ヘッダ | #include <stdio.h> |
I/F | size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream); |
戻り値 | 読取りに成功した要素の個数。 |
詳細 | fread関数は、streamが指すストリームから、大きさがsizeの要素を、最大nmemb個、配列ptrに読み込む。fread関数は、fgetc関数をsize回呼び出し、読み取った順番に、unsigned char型の配列に結果を格納する。そのストリームのファイル位置表示子がもし定義されていれば、そのファイル位置表示子を読み込んだ文字数分進める。エラー発生の場合、そのストリームのファイル位置表示子の値は不定である。戻り値である読取りに成功した要素の個数は、読取りエラー発生の場合、あるいはファイルの終端に達した場合、nmembより小さくなる可能性がある。size又はnmembが0のとき、fread関数は0を返却する。 |