ftell

(PHP 4, PHP 5, PHP 7)

ftellВозвращает текущую позицию указателя чтения/записи файла

Описание

ftell ( resource $handle ) : int

Возвращает позицию файлового указателя handle.

Список параметров

handle

Файловый указатель должен быть действующим указателем на поток, открытый функциями fopen() или popen(). ftell() возвращает неопределённые результаты для потоков, разрешающих только запись в конец (открытых с флагом "a").

Возвращаемые значения

Возвращает позицию файлового указателя handle в виде целого числа, то есть его смещение в файловом потоке.

При возникновении ошибки возвращает FALSE.

Замечание: Так как тип integer в PHP является целым числом со знаком и многие платформы используют 32-х битные целые числа, то некоторые функции файловых систем могут возвращать неожиданные результаты для файлов размером больше 2 Гб.

Примеры

Пример #1 Пример использования функции ftell()

<?php

// открываем файл и читаем немного данных
$fp fopen("/etc/passwd""r");
$data fgets($fp12);

// где же мы ?
echo ftell($fp); // 11

fclose($fp);

?>

Смотрите также

  • fopen() - Открывает файл или URL
  • popen() - Открывает файловый указатель процесса
  • fseek() - Устанавливает смещение в файловом указателе
  • rewind() - Сбрасывает курсор файлового указателя