ftell

(PHP 4, PHP 5, PHP 7, PHP 8)

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

Описание

ftell(resource $stream): int|false

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

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

stream

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

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

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

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

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

Примеры

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

<?php

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

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

fclose($fp);

?>

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

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