(PECL eio >= 0.0.1dev)
eio_read — Читает данные из файла, начиная с заданного смещения
$fd
, int $length
, int $offset
, int $pri
, callable $callback
[, mixed $data
= NULL
] ) : resource
eio_read() считывает length
байт из
файла с описателем fd
, начиная с байта
offset
. Прочитанные данные передаются через параметр
result
в функцию callback
.
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() передает считанные данные через параметр
result
в функцию callback
.
Пример #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"