ftell

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

    ftell — Retorna a posição atual do ponteiro de leitura/gravação do arquivo

    Descrição

    ftell(resource$stream): int|false

    Retorna a posição do ponteiro do arquivo referenciado por stream.

    Parâmetros

    stream

    O ponteiro de arquivo precisa ser válido, e deve apontar para um arquivo aberto com sucesso por fopen() ou popen(). ftell() dá resultados indefinidos para fluxos no modo de acréscimo (abertos com a opção "a").

    Valor Retornado

    Retorna a posição do ponteiro do arquivo referenciado por stream como um inteiro; isto é, seu deslocamento no fluxo do arquivo.

    Se um erro ocorrer, retorna false.

    Nota: Como o tipo inteiro do PHP possui sinal e muitas plataformas usam números inteiros de 32 bits, algumas funções do sistema de arquivos podem retornar resultados inesperados para arquivos maiores que 2GB.

    Exemplos

    Exemplo #1 Exemplo de ftell()

    <?php

    // abre o arquivo e lê alguns dados
    $fp = fopen("/etc/passwd", "r");
    $data = fgets($fp, 12);

    // onde estamos?
    echo ftell($fp); // 11

    fclose($fp);

    ?>

    Veja Também

    • fopen() - Abre um arquivo ou URL
    • popen() - Abre um processo como ponteiro de arquivo
    • fseek() - Procura (seeks) em um ponteiro de arquivo
    • rewind() - Retrocede a posição de um ponteiro de arquivos
    To Top