manページ  — READ

read, readv, pread – 入力を読み取る

ライブラリ 書式 解説 戻り値 エラー 関連項目 規格 歴史

Standard C Library (libc, -lc)

#include <sys/types.h>

#include <sys/uio.h>

#include <unistd.h>

ssize_t
read(int d, void *buf, size_t nbytes);

ssize_t
readv(int d, const struct iovec *iov, int iovcnt);

ssize_t
pread(int d, void *buf, size_t nbytes, off_t offset);

正常に完了すると、実際に読み取られたバイト数が返されます。 ファイル終了 (EOF) が読み取られると 0 が返されます。 そうでない場合は -1 が返され、エラーを示すためにグローバル変数 errno が設定されます。

read(), readv() および pread() システムコールは次の場合を除いて正常に完了します:

[EBADF]
	d 引数は読取り用にオープンされた有効なファイルまたは ソケットの記述子ではありません。
[EFAULT]
	buf 引数は、プロセスに割り当てられたアドレス空間の範囲外を指しています。
[EIO]	ファイルシステムから読み取っている間に入出力エラーが発生しました。
[EINTR]
	データが到着する前に、シグナルの配送により低速デバイスからの読取りが 割り込まれました。
[EINVAL]
	d に結び付けられたポインタが負でした。
[EAGAIN]
	ファイルは非ブロッキング入出力とマークされており、 読取りの準備ができたデータがありません。
[EISDIR]
	ファイル記述子が、ディレクトリ上での普通の読み込み操作を許可していない ファイルシステム (例えば NFS) に属しているディレクトリに 関連付けられています。
[EOPNOTSUPP]
	ファイル記述子が、普通の読み込み操作を許可していないファイルシステムおよび ファイルタイプに関連付けられています。
[EOVERFLOW]
	ファイル記述子が普通のファイルに関連付けられていて、 nbytes が 0 よりも大きく、 offset がファイルの末尾の前にあり、かつ offset がこのファイルシステムに収まるオフセットの最大値以上です。

さらに、 readv() は次のエラーのうちの 1 つを返すことがあります:

[EINVAL]
	iovcnt 引数が 0 以下であるか、または IOV_MAX より大きくなっています。
[EINVAL]
	iov 配列の中の iov_len 値の 1 つが負でした。
[EINVAL]
	iov 配列の中の iov_len 値の合計が 32 ビット整数をオーバフローしました。
[EFAULT]
	iov の一部が、プロセスに割り当てられたアドレス空間の範囲外を指しています。

pread() システムコールは次のエラーを返すこともあります:

[EINVAL]
	offset の値が負です。
[ESPIPE]
	ファイル記述子がパイプ、ソケット、または FIFO に結び付けられています。

read() システムコールは IEEE Std 1003.1-90 ("POSIX.1") に適合しています。 readv() システムコールと pread() システムコールは -xpg4.2 に適合しています。

pread() 関数は AT&T V.4 で登場しました。 readv() システムコールは BSD 4.2 で登場しました。 read() 関数は AT&T v6 で登場しました。