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

# gzseek

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### Описание

function gzseek(resource `$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-файла в начало

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open