(PHP 4, PHP 5, PHP 7, PHP 8)
gzseek — Déplace le pointeur de lecture
$stream, int $offset, int $whence = SEEK_SET): int
gzseek() place le pointeur de lecture du fichier
zp à la position offset,
comptée en octets depuis le début du fichier. C'est l'équivalent
de la fonction gzseek(zp, offset, SEEK_SET),
du langage C.
Si le fichier est ouvert en lecture, cette fonction est alors émulée, et se révèle extrêmement lente. Si le fichier est ouvert en écriture, seuls les déplacements vers l'avant sont supportés : gzseek() compresse alors une série de zéros jusqu'à la nouvelle position.
streamLe pointeur de fichier gz. Il doit être valide et doit pointer vers un fichier ouvert avec succès grâce à la fonction gzopen().
offsetLa position désirée.
whence
Les valeurs de whence sont :
SEEK_SET : ramène la position à l'offset.SEEK_CUR : ramène la position à la position actuelle plus offset.
Si whence n'est pas spécifié, il vaut par défaut
SEEK_SET.
0 en cas de réussite, -1 sinon. Notez que placer le pointeur au delà de la fin du fichier n'est pas considéré comme une erreur.
Exemple #1 Exemple avec gzseek()
<?php
$gz = gzopen('somefile.gz', 'r');
gzseek($gz,2);
echo gzgetc($gz);
gzclose($gz);
?>