ftell

(PHP 4, PHP 5, PHP 7)

ftell — Ermittelt die aktuelle Position des Dateizeigers

Beschreibung

ftell ( resource $handle ) : int

Gibt die aktuelle Position des Dateizeigers, der durch handle referenziert wird, zurück.

Parameter-Liste

handle: Der Dateizeiger muss gültig sein und auf eine erfolgreich durch fopen() oder popen() geöffnete Datei zeigen. ftell() liefert undefinierte Ergebnisse für reine Anfüge-Streams (geöffnet mit einem "a" Flag).

Rückgabewerte

Gibt die aktuelle Position des Dateizeigers, der durch handle referenziert wird, als Integerzahl zurück, d.h. den Offset im Dateistream.

Wenn ein Fehler auftritt, wird FALSE zurückgegeben.

Hinweis: Weil PHPs Integer Typ vorzeichenbehaftet ist und viele Platformen 32bit Integer verwenden, können einige Dateisystem-Funktionen für Dateien größer als 2GB unerwartete Ergebnisse liefern.

Beispiele

Beispiel #1 ftell() Beispiel


<?php

// öffnet eine Datei und liest einige Daten
$fp = fopen("/etc/passwd", "r");
$data = fgets($fp, 12);

// wo sind wir?
echo ftell($fp); // 11

fclose($fp);

?>

Siehe auch

fopen() - Öffnet eine Datei oder URL
popen() - Öffnet einen Prozesszeiger
fseek() - Positioniert den Dateizeiger
rewind() - Setzt die Position eines Dateizeigers auf den Anfang