fread(3)

fread, fwrite − バイナリストリーム入出力

標準 C ライブラリ (libc, −lc)

#include <stdio.h>

size_t

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

size_t

fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream);

解説

fread() 関数は、 stream が指すストリームから、それぞれが size バイトの大 きさのオブジェクトを nmemb 個読み込み、 ptr で指定された場所に保存しま す。

fwrite() 関数は、 ptr で指定された場所から、それぞれが size バイトの大き さのオブジェクトを nmemb 個 stream が指すストリームに書き込みます。

fread() 関数と fwrite() 関数は、読み書きしたバイト数だけストリームのファ イル位置インジケータを進め、読み書きしたオブジェクト数を返します。エラー が発生した場合、またはファイルの終了に達した場合は、指定したものより少な いオブジェクト数 (または 0) を返します。

fread() 関数は、ファイルの終了とエラーを区別しません。ファイルの終了かエ ラーかを判断するためには、呼び出し側が feof(3) と ferror(3) を使用する必 要があります。 fwrite() は、書き込みエラーが発生した場合に限って nmemb よ り少ない値を返します。

read(2), write(2)

fread() 関数と fwrite() 関数は、 ISO/IEC 9899:1990 (‘‘ISO C89’’) に適合し ています。

FreeBSD 10.0 March 8, 1994 FreeBSD 10.0