(PECL eio >= 0.0.1dev)
eio_read — 从给定偏移量的文件描述符读取
eio_read() 从 fd
文件描述符的 offset
偏移量处读取最多 length
个字节。读取的字节存储在 callback
的 result
参数中。
fd
流、套接字资源或数值文件描述符
length
要读取的最大字节数。
offset
文件中的偏移量。
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_read() 将读取的字节存储在 callback
函数的 result
参数中。
示例 #1 eio_read() 示例
<?php
// 打开一个临时文件并在其中写入一些字节
$temp_filename = "eio-temp-file.tmp";
$fp = fopen($temp_filename, "w");
fwrite($fp, "1234567890");
fclose($fp);
/* 当 eio_read() 完成时被调用 */
function my_read_cb($data, $result) {
global $temp_filename;
// 输出读取的字节
var_dump($result);
// 关闭文件
eio_close($data);
eio_event_loop();
// 删除临时文件
@unlink($temp_filename);
}
/* 当 eio_open() 完成时被调用 */
function my_file_opened_callback($data, $result) {
// $result 应该包含文件描述符
if ($result > 0) {
// 从第三个开始读取 5 个字节
eio_read($result, 5, 2, EIO_PRI_DEFAULT, "my_read_cb", $result);
eio_event_loop();
} else {
// eio_open() 失败
unlink($data);
}
}
// 以读写模式打开文件
eio_open($temp_filename, EIO_O_RDWR, NULL,
EIO_PRI_DEFAULT, "my_file_opened_callback", $temp_filename);
eio_event_loop();
?>
上面的示例将输出类似以下内容
string(5) "34567"