eio_seek

(PECL eio >= 0.5.0b)

eio_seek — Перемещает файловый указатель файла fd на число байт offset в соответствии с директивой whence

Описание

eio_seek(
    mixed $fd,
    int $offset,
    int $whence,
    int $pri = EIO_PRI_DEFAULT,
    callable $callback = NULL,
    mixed $data = NULL
): resource

eio_seek() изменяет смещение файлового указателя, связанного с потоком, ресурсом сокета или файловым дескриптором fd на значение offset. При этом текущая позиция файлового указателя будет вычисляться в соответствии со значением директивы whence следующим образом:

EIO_SEEK_SET - Установка текущей позиции на offset байт от начала файла.
EIO_SEEK_CUR - Смещение текущей позиции на offset байт вперёд.
EIO_SEEK_END - Установка указателя на позицию конец-файла плюс offset байт.

Список параметров

fd

Поток, ресурс сокета или числовой дескриптор файла

offset

Начальная позиция, с которой будут читаться данные

length

Число байт, которое необходимо прочитать

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_seek() возвращает ресурс запроса в случае успешного выполнения или false в случае возникновения ошибки.

add a note

User Contributed Notes

There are no user contributed notes for this page.