PHP
Referenzliste
fseek
Dateisystem-Funktionen
Befehl:
int fseek ( resource $handle , int $offset [, int $whence ] )
Parameter-Liste:
Beschreibung | |
---|---|
Eine Dateisystemressource (resource), wie sie in der Regel von fopen() zurückgegeben wird. | |
Der Offset. Um zu einer Position vor dem End-of-Datei zu verschieben, müssen Sie einen negativen Wert in offset und Satz whence SEEK_END . | |
whence Werte sind:
|
Rückgabewerte:
Bei Erfolg gibt es 0 zurück, andernfalls gibt es -1 zurück.
Beschreibung:
Setzt den Dateizeiger einer mit handle angegebenen Datei auf eine neue Position. Diese neue Position, angegeben in Bytes vom Beginn der Datei an, wird definiert durch Hinzufügen von offset zu der Position spezifiziert durch whence, deren Werte wie folgt definiert sind:
• SEEK_SET Setzt Position gleich offset bytes.
• SEEK_CUR Setzt Position auf die aktuelle Stelle plus offset.
• SEEK_END Setzt die Position ans Ende der Datei plus offset. (Um zu einer Position vor EOF zu gelangen, übergeben Sie in offset einen negativen Wert.)
Wenn whence nicht angegeben wurde, wird SEEK_SET angenommen.
Bei Erfolg wird '0' zurückgegeben, andernfalls '-1'. Beachten Sie, dass die Überschreitung des Dateiendes (EOF) nicht als Fehler bewertet wird.
Diese Funktion sollte nicht auf Dateizeiger angewandt werden, die durch die Verwendung von "http://" oder "ftp://" bei der Funktion fopen() erhalten wurden.
• SEEK_SET Setzt Position gleich offset bytes.
• SEEK_CUR Setzt Position auf die aktuelle Stelle plus offset.
• SEEK_END Setzt die Position ans Ende der Datei plus offset. (Um zu einer Position vor EOF zu gelangen, übergeben Sie in offset einen negativen Wert.)
Wenn whence nicht angegeben wurde, wird SEEK_SET angenommen.
Bei Erfolg wird '0' zurückgegeben, andernfalls '-1'. Beachten Sie, dass die Überschreitung des Dateiendes (EOF) nicht als Fehler bewertet wird.
Diese Funktion sollte nicht auf Dateizeiger angewandt werden, die durch die Verwendung von "http://" oder "ftp://" bei der Funktion fopen() erhalten wurden.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Hinweis:
Hinweis:
Das whence-Argument wurde nach PHP 4.0.0 eingeführt.
Hinweis:
Hinweis:
Wenn Sie die Datei im Anfügen (a oder a +)-Modus, werden alle Daten, die Sie in die Datei schreiben immer angehängt werden, unabhängig von der Position in der Datei, und das Ergebnis des Aufrufs fseek() geöffnet haben undefiniert.
Nicht alle Streams Unterstützung suchen. Für diejenigen, die keine Unterstützung suchenden, nach vorne sucht von der aktuellen Position wird durch das Lesen und Verwerfen von Daten erreicht, andere Formen des Suchens wird scheitern.
Siehe auch:
fseek() - Beispiel:
Eingabe:
<?PHP //Inhalt der Datei member.txt: Damir Enseleit 1971 $fp = fopen ( 'users.txt', 'r' ); $zahl = fgetc ( $fp ); fseek ( $fp, 2, 'SEEK_CUR' ); $zahl = fgets ( $fp, 20 ); echo $zahl; ?>
Ausgabe:
mir Enseleit 1971
fseek() - Beispiel 2:
Eingabe:
<?PHP $fp = fopen('somefile.txt', 'r'); // einige Daten lesen $data = fgets($fp, 4096); // bewegen den Zeiger zurück an den Anfang der Datei, entspricht rewind($fp); fseek($fp, 0); ?>
Dateisystem-Funktionen