gzseek
(PHP 4, PHP 5)
gzseek — Ubica el apuntador a un archivo gz
Descripción
$zp
, int $offset
[, int $whence = SEEK_SET
] )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
-
zp -
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
whenceson:SEEK_SET- Establece la posición igual aloffsetde bytes.SEEK_CUR- Establece la posición en la posición actual más eloffset.
Si
whenceno se especifica, se asume que esSEEK_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
Ejemplo #1 Ejamplo de gzseek()
<?php
$gz = gzopen('somefile.gz', 'r');
gzseek($gz,2);
echo gzgetc($gz);
gzclose($gz);
?>
Ver también
- gztell() - Indica la posición de lectura/escritura del apuntador al archivo gz
- gzrewind() - Reinicia la posición del apuntador a un archivo gz