ftell

(PHP 4, PHP 5)

ftell — Renvoie la position courant du pointeur de fichier

Description

int ftell ( resource $handle )

Renvoie la position du pointeur courante du pointeur de fichier.

Liste de paramètres

handle: Le pointeur de fichier doit être valide, et avoir été correctement ouvert par fopen() ou popen(). ftell() donne des résultats non définis pour les flux "append-only" (ouvert avec le flag "a").

Valeurs de retour

Retourne la position courante du pointeur dans le fichier repéré par le pointeur handle sous la forme d'un entier, i.e., sa position dans le flux du fichier.

Si une erreur survient, la fonction retournera FALSE.

Note: Comme le type entier de PHP est signé et que de nombreuses plates-formes utilisent des entiers de 32 bits, certaines fonctions relatives au système de fichiers peuvent retourner des résultats étranges pour les fichiers de taille supérieure à 2 Go.

Exemples

Exemple #1 Exemple avec ftell()

<?php

// Ouvre un fichier et y lit quelques données
$fp = fopen("/etc/passwd", "r");
$data = fgets($fp, 12);

// Où en sommes-nous ?
echo ftell($fp); // 11

fclose($fp);

?>

Voir aussi

fopen() - Ouvre un fichier ou une URL
popen() - Crée un processus de pointeur de fichier
fseek() - Modifie la position du pointeur de fichier
rewind() - Replace le pointeur de fichier au début

fstat

Fonctions sur les systèmes de fichiers

ftruncate

Manuel PHP