ftell

(PHP 4, PHP 5, PHP 7)

ftell — Devuelve la posición de lectura/escritura actual del puntero a un fichero

Descripción

ftell ( resource $handle ) : int

Devuelve la posición del puntero al fichero referido por handle.

Parámetros

handle: El puntero al fichero debe ser válido, y debe apuntar a un fichero abierto con éxito por fopen() o popen(). ftell() da resultados indefinidos para flujos de sólo agregado (abiertos con la bandera "a").

Valores devueltos

Devuelve la posición del puntero al fichero referido por handle como un entero; esto es, su índice dentro del flujo de fichero.

Si se produjo un error, devuelve 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 de ftell()


<?php

// abre un fichero y leer algunos datos
$fp = fopen("/etc/passwd", "r");
$información = 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() - Busca sobre un puntero a un fichero
rewind() - Rebobina la posición de un puntero a un archivo