CascadiaPHP 2024

eio_seek

(PECL eio >= 0.5.0b)

eio_seekПеремещает положение файлового указателя

Описание

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

Функция eio_seek() перемещает положение файлового указателя в открытом файле, который связан с Socket-ресурс потока или файловым дескриптором параметра fd, на значение аргумента offset в соответствии со значением директивы whence, которая принимает следующие значения:

  • EIO_SEEK_SET — Перемещает указатель в положение, равное количеству байтов смещения offset от начала файла.
  • EIO_SEEK_CUR — Перемещает указатель вперёд — в положение, равное количеству байтов смещения offset от текущей позиции.
  • EIO_SEEK_END — Перемещает указатель за пределы конца файла — в положение, равное количеству байтов смещения offset от конца файла.

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

fd

Socket-ресурс потока или числовой дескриптор файла.

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.
To Top