gzrewind
gztell
Zlib-Funktionen
PHP Manual

# gzseek

(PHP 4, PHP 5)

gzseek — Positioniert innerhalb einer gz-Datei

### Beschreibung

int gzseek ( resource `$zp` , int `$offset` [, int `$whence`= SEEK_SET ] )

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

`zp`

  Die gz-Datei Resource. Dies 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 das 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 in einer gz-Datei
- gzrewind() - Setzt die Dateiposition auf den Anfang zurück

gzrewind
gztell
Zlib-Funktionen
PHP Manual