CakeFest 2024: The Official CakePHP Conference

eio_read

(PECL eio >= 0.0.1dev)

eio_read Читает данные из файла, начиная с заданного смещения

Описание

eio_read(
    mixed $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 до тех пор, пока все запросы не будут выполнены
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top