ftell

    (PHP 4, PHP 5, PHP 7, PHP 8)

    ftell — Renvoie la position courante du pointeur de fichier

    Description

    ftell(resource$stream): int|false

    Renvoie la position courante du pointeur de fichier référencé par stream.

    Liste de paramètres

    stream

    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 stream 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
    To Top