freadのヘルプ・マニュアル
日本語 英語
fread --help
man fread
FREAD(3) Linux Programmer’s Manual FREAD(3)
名前
fread, fwrite - バイナリストリームの入出力
書式
#include
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 ポインタで指定されたストリームから nmemb 個のデー
タを読み込み、 ptr で与えられた場所に格納する。個々のデータは size バイ
トの長さを持つ。
fwrite() 関 数 は ptr で指定された場所から得た nmemb 個のデータを、
stream ポインタで指定されたストリームに書き込む。個々のデータは size バ
イトの長さを持つ。
これらの処理をロックせずに行いたいときは、 unlocked_stdio(3) を参照のこ
と。
返り値
fread() と fwrite() は読み書きに成功した要素の個数を返す。エラーが生 じ
た場合や、end-of-file(ファイルの最後)に達した場合、返り値は指定した個数
よりも小さい値(またはゼロ)となる。
fread() は end-of-file とエラーを区別しないので、どちらが生じたかを判断
す るためには、呼び出し側で feof(3) と ferror(3) とを使用しなければなら
ない。
準拠
C89, POSIX.1-2001.
関連項目
read(2), write(2), feof(3), ferror(3), unlocked_stdio(3)
GNU 1996-05-17 FREAD(3)
FREAD(3) Linux Programmer’s Manual FREAD(3)
NAME
fread, fwrite - binary stream input/output
SYNOPSIS
#include
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);
DESCRIPTION
The function fread() reads nmemb elements of data, each size bytes
long, from the stream pointed to by stream, storing them at the loca-
tion given by ptr.
The function fwrite() writes nmemb elements of data, each size bytes
long, to the stream pointed to by stream, obtaining them from the loca-
tion given by ptr.
For non-locking counterparts, see unlocked_stdio(3).
RETURN VALUE
fread() and fwrite() return the number of items successfully read or
written (i.e., not the number of characters). If an error occurs, or
the end-of-file is reached, the return value is a short item count (or
zero).
fread() does not distinguish between end-of-file and error, and callers
must use feof(3) and ferror(3) to determine which occurred.
CONFORMING TO
C89, POSIX.1-2001.
SEE ALSO
read(2), write(2), feof(3), ferror(3), unlocked_stdio(3)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
GNU 1996-05-17 FREAD(3)