SplFileObject::seek

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

SplFileObject::seek — Перемещает файловый указатель на заданную строку

Описание

public SplFileObject::seek(int $line): void

Метод перемещает файловый указатель на заданную строку.

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

line: Номер строки, на которую требуется переместить указатель. Отсчёт строк ведётся с 0.

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

Функция не возвращает значения после выполнения.

Ошибки

Метод выбрасывает исключение LogicException, если в параметр line передали отрицательное значение.

Примеры

Пример #1 Пример использования метода SplFileObject::seek()

Пример выводит третью строку скрипта, которая находится на 2-й позиции.

<?php

$file = new SplFileObject(__FILE__);
$file->seek(2);
echo $file->current();

?>

Вывод приведённого примера будет похож на:

$file->seek(2);

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

SplFileObject::current() - Получает текущую строку файла
SplFileObject::key() - Получает номер строки
SplFileObject::next() - Считывает следующую строку
SplFileObject::rewind() - Отматывает файловый указатель в начало файла
SplFileObject::valid() - Проверяет, достигнут ли конец файла (EOF)

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 2 notes

down

info at inatica dot com ¶

3 years ago

there is a bug using fseek on previos versions of PHP8.0.1
See:

https://bugs.php.net/bug.php?id=46569

https://3v4l.org/O89dJ

I solved it with a function:

<?php
/**
* SEEK an Spl object
* There is a bug in php for seeking files
* seems solved php_version > PHP8.0.1
* See https://bugs.php.net/bug.php?id=46569
* & https://3v4l.org/O89dJ
*
* $Spl->seek() Works ok in all versions with offset 0 (first row)
* On PHP_VERSION < 8.0.1:
*  - Offset 1: seek() cannot seek at row 1. It will be done manually, rewind file and reading first row
*  - Rest of Offsets: The cursor remains at next row of $Offset
*
* @param SplObject $Spl
* @param int $Offset
*/

function seek_spl($Spl, $Offset){
    if (version_compare(PHP_VERSION, '8.0.1', '>=') || $Offset == 0) {
        $Spl->seek($Offset);
    } else {
        if( $Offset == 1 ){
            $Spl->rewind(); // Ensure to go at first row before exit
            $Spl->fgets(); // Read line 0. Cursor remains now at line 1
        } else {
            $Spl->seek($Offset-1);
        }
    }
}?>

down

ahmad_maqsood at waku-2 dot com ¶

7 years ago

A sleek way of counting the number of lines in a file can be like below

$file = new \SplFileObject('file.extension', 'r');
$file->seek(PHP_INT_MAX);

echo $file->key() + 1;

＋Добавить