>PHP: ftell - Manual

ftell

(PHP 3, PHP 4, PHP 5)

ftell -- Indica la posiciÃ³n de lectura/escritura del apuntador de archivo

DescripciÃ³n

int ftell ( resource gestor )

Devuelve la posiciÃ³n del apuntador de archivo indicado por gestor; es decir, su desplazamiento al interior de la secuencia de archivo.

Si ocurre un error, devuelve FALSE.

El apuntador de archivo debe ser vÃ¡lido, y debe apuntar a un archivo abierto satisfactoriamente por fopen() o popen(). ftell() entrega resultados indefinidos para secuencias de adiciÃ³n (abiertas con la bandera "a").

Ejemplo 1. Ejemplo de ftell()

<?php // abre un archivo y lee algunos datos $da = fopen("/etc/passwd", "r"); $datos = fgets($da, 12); // en donde estamos ? echo ftell($da); // 11 fclose($da); ?>

Vea tambiÃ©n fopen(), popen(), fseek(), and rewind().

add a note User Contributed Notes
ftell

mbirth at webwriters dot de
21-Oct-2005 11:09


Attention! If you open a file with the "text"-modifier (e.g. 'rt') and the file contains \r\n as line-endings, ftell() returns the position as if there were only \n as line-endings.



Example:

If the first line only contains 1 char followed by \r\n, the start of the second line should be position 3. (1char + \r + \n = 3 bytes) But ftell() will return 2 - ignoring one byte. If you call ftell() in line 3, the value will differ from the real value by 2 bytes. The error gets greater with every line.



(Watched this behavior in PHP 5.0.4 for Windows.)



BUT: fseek() works as expected - using the true byte values.

mweierophinney at gmail dot com
21-Jun-2005 10:00


Actually, ftell() gives more than an undefined result for append only streams; it gives the offset from the end of the file as defined before any data was appended. So if you open a file that had 3017 characters, and append 41 characters, and then execute ftell(), the value returned will be 41.

php at michielvleugel dot com
01-Jun-2005 03:19


When trying to determine whether or not something was piped into a command line script, it is not smart to do a fgets(STDIN), because it will wait indefenitely if nothing is piped. Instead, I found ftell on STDIN to be very handy: it will return an integer of zero when something was piped, and nothing if nothing was piped to the script.



#!/usr/bin/php4 -q

<?

#following will hang if nothing is piped:

#$sometext = fgets(STDIN, 256)



$tell = ftell(STDIN);



if (is_integer($tell)==true) 

  {echo "Something was piped: ".fread(STDIN,256)."\n";}

else 

  {echo "Nothing was piped\n";}



?>

add a note

MANUAL DE PHP

windsurf mercedes camper

ftell

DescripciÃ³n