gzseek

(PHP 4, PHP 5)

gzseek — Перемещает указатель на позицию в gz-файле

Описание

int gzseek ( resource $zp , int $offset [, int $whence = SEEK_SET ] )

Устанавливает указатель на позицию в файле, на который ссылается zp. Выполняется смещение потока этого файла на указанное количество байт. Эквивалентно вызову (в C) gzseek(zp, offset, SEEK_SET).

Если файл открыт для чтения, функция эмулируется, при этом будет работать очень медленно. Если файл открыт для записи, разрешено только перемещение вперёд; gzseek() при этом сжимает последовательность нулей до новой позиции.

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

zp

Указатель на 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-файле в начало