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: Debido a que el tipo integer de PHP es con signo y muchas plataformas usan enteros de 32 bits, algunas funciones de sistema de ficheros pueden devolver resultados inesperados para ficheros que son mayores de 2 GB.

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() - Abre un proceso de un puntero a un fichero
  • fseek() - Modifica la posición del puntero de archivo
  • rewind() - Rebobina la posición de un puntero a un archivo