# gzseek

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

gzseek — Positioniert den gz-Dateizeiger

### Beschreibung

gzseek(resource `$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`

  `whence` gibt an, auf welche Anfangsposition sich `offset` bezieht. Mögliche Werte sind:

  - `SEEK_SET` - Setzt die Position auf `offset` Bytes vom Dataianfang.
  - `SEEK_CUR` - Verschiebt die Position um `offset` Bytes ausgehend von der aktuellen Position.

  Wird `whence` nicht angegeben, so wird `SEEK_SET` angenommen.

### 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

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