eio_seek
(PECL eio >= 0.5.0b)
eio_seek —
Перемещает файловый указатель файла fd
на число байт
offset
в соответствии с директивой
whence
Описание
$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
в
случае возникновения ошибки.