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($result52EIO_PRI_DEFAULT"my_read_cb"$result);
        
eio_event_loop();
    } else {
  
// eio_open() завершила работу отказом
        
unlink($data);
    }
}

// открываем файл для чтения и записи
eio_open($temp_filenameEIO_O_RDWRNULL,
    
EIO_PRI_DEFAULT"my_file_opened_callback"$temp_filename);
eio_event_loop();
?>

Результатом выполнения данного примера будет что-то подобное:

string(5) "34567"

Смотрите также

  • eio_open() - Открывает файл
  • eio_write() - Запись в файл
  • eio_close() - Close file
  • eio_event_loop() - Взаимодействует с libeio до тех пор, пока все запросы не будут выполнены