eio_read
(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"
Смотрите также
- eio_open() - Открывает файл
- eio_write() - Запись в файл
- eio_close() - Закрыть файл
- eio_event_loop() - Взаимодействует с libeio до тех пор, пока все запросы не будут выполнены