ftell

(PHP 4, PHP 5, PHP 7)

ftell — Returns the current position of the file read/write pointer

Descrierea

ftell ( resource $handle ) : int

Returns the position of the file pointer referenced by handle.

Parametri

handle

The file pointer must be valid, and must point to a file successfully opened by fopen() or popen(). ftell() gives undefined results for append-only streams (opened with "a" flag).

Valorile întoarse

Returns the position of the file pointer referenced by handle as an integer; i.e., its offset into the file stream.

If an error occurs, returns FALSE.

Notă: Deoarece tipul întreg al PHP este cu semn și multe platforme utilizează întregi de 32 de biți, unele funcții ale sistemului de fișiere pot întoarce rezultate neașteptate pentru fișiere ce depășesc 2GB.

Exemple

Example #1 ftell() example

<?php

// opens a file and read some data
$fp = fopen("/etc/passwd", "r");
$data = fgets($fp, 12);

// where are we ?
echo ftell($fp); // 11

fclose($fp);

?>

A se vedea și

  • fopen() - Opens file or URL
  • popen() - Opens process file pointer
  • fseek() - Seeks on a file pointer
  • rewind() - Rewind the position of a file pointer