eio_read

(PECL eio >= 0.0.1dev)

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

Описание

function 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 до тех пор, пока все запросы не будут выполнены