ftell

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

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

Описание

ftell(resource $stream): int|false

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

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

stream

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

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

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

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

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

Примеры

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

<?php

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

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

fclose($fp);

?>

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

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