gzseek
(PHP 4, PHP 5, PHP 7, PHP 8)
gzseek — Positioniert den gz-Dateizeiger
Beschreibung
$stream, int $offset, int $whence = SEEK_SET): int
Setzt die Schreib-/Leseposition für die angegebene Datei.
Dies entspricht dem C-API Aufruf
gzseek(zp, offset, SEEK_SET).
Wenn die Datei für Lesezugriffe geöffnet ist, wird diese Funktion emuliert und kann sehr langsam sein. Wenn die Datei zum Schreiben geöffnet ist, kann nur vorwärts positioniert werden; die Funktion komprimiert dann eine Sequenz von Nullbytes, um die gewünschte Position zu erreichen.
Parameter-Liste
-
stream -
Der gz-Dateizeiger. Dieser muss auf eine gültige, erfolgreich mit gzopen() geöffnete Datei zeigen.
-
offset -
Die gewünschte Position.
-
whence -
whencegibt an, auf welche Anfangsposition sichoffsetbezieht. Mögliche Werte sind:SEEK_SET- Setzt die Position aufoffsetBytes vom Dataianfang.SEEK_CUR- Verschiebt die Position umoffsetBytes ausgehend von der aktuellen Position.
Wird
whencenicht angegeben, so wirdSEEK_SETangenommen.
Rückgabewerte
Gibt 0 bei Erfolg und -1 bei Fehlern zurück. Beachten Sie, dass eine Suche über das Dateiende hinaus nicht als Fehler gilt.
Beispiele
Beispiel #1 gzseek()-Beispiel
<?php
$gz = gzopen('somefile.gz', 'r');
gzseek($gz,2);
echo gzgetc($gz);
gzclose($gz);
?>
Siehe auch
- gztell() - Ermittelt die aktuelle Position eines gz-Dateizeigers
- gzrewind() - Setzt den gz-Dateizeiger auf den Anfang zurück
