ftell

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

ftellDevuelve la posición actual del puntero de archivo

Descripción

ftell(resource $stream): int|false

Devuelve la posición actual del puntero de archivo referenciado por stream.

Parámetros

stream

El puntero de archivo debe ser válido y haber sido abierto correctamente por fopen() o popen(). ftell() proporciona resultados no definidos para los flujos "append-only" (abiertos con el flag "a").

Valores devueltos

Devuelve la posición actual del puntero en el archivo identificado por el puntero stream en forma de entero, es decir, su posición en el flujo del archivo.

Si ocurre un error, la función devolverá false.

Nota: Como el tipo entero de PHP es firmado y que muchas plataformas utilizan enteros de 32 bits, algunas funciones relacionadas con el sistema de archivos pueden retornar resultados extraños para archivos de tamaño superior a 2 Go.

Ejemplos

Ejemplo #1 Ejemplo con ftell()

<?php

// Abre un archivo y lee algunos datos
$fp = fopen("/etc/passwd", "r");
$data = fgets($fp, 12);

// ¿Dónde estamos?
echo ftell($fp); // 11

fclose($fp);

?>

Ver también

  • fopen() - Abre un fichero o un URL
  • popen() - Crea un puntero de archivo de proceso
  • fseek() - Modifica la posición del puntero de archivo
  • rewind() - Reemplaza el puntero de fichero al inicio