eio_sendfile
(PECL eio >= 0.0.1dev)
eio_sendfile — ファイルディスクリプタ間でデータを転送する
説明
eio_sendfile
( mixed
$out_fd
, mixed $in_fd
, int $offset
, int $length
[, int $pri
[, callable $callback
[, string $data
]]] ) : resourceeio_sendfile() は、一方のファイルディスクリプタから もう一方のファイルディスクリプタにデータをコピーします。 詳細は SENDFILE(2) の man ページを参照ください。
パラメータ
-
out_fd -
出力先のストリーム、ソケットリソース、あるいはファイルディスクリプタ。 書き込みモードでのオープンが必須です。
-
in_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_sendfile()
は、成功した場合にリクエストリソースを返します。エラー時に FALSE を返します。