Documentación offline PHP master

gzseek

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

gzseek

Ubica el apuntador a un archivo gz

Descripción#

gzseek(resource $stream, int $offset, [int $whence]): int
```php

Establece el indicador de posición para el apuntador al archivo dado en el desplazamiento de bytes fijado en el flujo del archivo. Es equivalente a llamar (en C) a `gzseek(zp, offset, SEEK_SET)`.

Si el archivo está abierto para lectura, ésta función es emulada pero puede ser extremadamente lenta. Si el archivo está abierto para escritura, sólo está soportada la búsqueda hacia adelante; entonces `gzseek` comprime una secuencia de ceros hasta la nueva posición de inicio.

## Parámetros

`stream`  
El apuntador al archivo gz. Debe ser válido y debe apuntar a un archivo abierto exitosamente por `gzopen`.

`offset`  
El desplazamiento buscado.

`whence`  
Los valores de `whence` son: `SEEK_SET` - Establece la posición igual al `offset` de bytes., `SEEK_CUR` - Establece la posición en la posición actual más el `offset`.

Si `whence` no se especifica, se asume que es `SEEK_SET`.

## Valores devueltos

En caso de éxito, retorna 0; en caso contrario, devuelve -1. Notese que buscar pasado el EOF no es considerado un error.

## Ejemplos

Ejamplo de `gzseek`

```php

Véase también#

gztell, gzrewind