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.

Note: 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

Example #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