eio_readahead

(PECL eio >= 0.0.1dev)

eio_readahead — ファイルを先読みしてページキャッシュに格納する

説明

resource eio_readahead ( mixed $fd , int $offset , int $length [, int $pri = EIO_PRI_DEFAULT [, callable $callback = NULL [, mixed $data = NULL ]]] )

eio_readahead() は、ファイルを先読みしてページキャッシュに格納します。それ以降の読み込みは、ディスク I/O をブロックしなくなります。詳細は READAHEAD(2) の man ページを参照ください。

パラメータ

fd

ストリーム、ソケットリソース、あるいは数値で表したファイルディスクリプタ。

offset

読み込みの開始位置。

length

読み込むバイト数。

pri

リクエストの優先順位。EIO_PRI_DEFAULT、EIO_PRI_MIN、EIO_PRI_MAX あるいは NULL を指定します。 NULL を渡した場合、pri は内部的に EIO_PRI_DEFAULT となります。

callback

callback 関数が、リクエスト終了時にコールされます。この関数のプロトタイプは、


void callback(mixed $data, int $result[, resource $req]);

に一致しなければなりません。

data: は、リクエストに渡すカスタムデータです。
result: にはリクエスト固有の結果が格納されます。基本的には、対応するシステムコールが返すそのままの値となります。
req: はオプションで指定するリクエストリソースです。 eio_get_last_error() のような関数で使えます。

data

callback に渡す任意の引数。

返り値

eio_readahead() は、成功した場合にリクエストリソースを返します。エラー時に FALSE を返します。