gzseek
(PHP 4, PHP 5, PHP 7)
gzseek — Переместить указатель на позицию в указателе gz-файла
Описание
$stream
, int $offset
, int $whence = SEEK_SET
) : int
Устанавливает указатель на позицию в файле, на который ссылается zp.
Выполняется смещение потока этого файла на указанное количество байт. Эквивалентно вызову (в C)
gzseek(zp, offset, SEEK_SET).
Если файл открыт для чтения, функция эмулируется, при этом будет работать очень медленно. Если файл открыт для записи, разрешено только перемещение вперёд; gzseek() при этом сжимает последовательность нулей до новой позиции.
Список параметров
-
stream -
Указатель на gz-файл, возвращённый, после его успешного открытия, функцией gzopen().
-
offset -
Смещение.
-
whence -
Значения параметра
whenceможет быть одним из следующих:SEEK_SET- Установить абсолютную позицию вoffsetбайт.SEEK_CUR- Установить позицию относительно текущего положения, добавив к нейoffset.
Если
whenceне указан, по умолчанию используетсяSEEK_SET.
Возвращаемые значения
При успешном завершении возвращает 0; иначе -1. Обратите внимание, что если установленное смещение перемещает указатель на позицию за EOF, это не является ошибкой.
Примеры
Пример #1 Пример использования gzseek()
<?php
$gz = gzopen('somefile.gz', 'r');
gzseek($gz,2);
echo gzgetc($gz);
gzclose($gz);
?>
Смотрите также
- gztell() - Возвращает текущую позицию чтения/записи в указателе gz-файла
- gzrewind() - Переместить позицию указатель gz-файла в начало