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($fp12);

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