(PHP 5 >= 5.1.0, PHP 7, PHP 8)
SplFileObject::fseek — Перемещает положение файлового указателя
Метод перемещает положение указателя в файле на позицию,
которую получает путём прибавления смещения offset
к положению, которое указали в параметре whence
.
Положение измеряется в байтах от начала файла.
offset
Смещение. Отрицательные значения указывают
для перемещения назад по файлу, что полезно, когда флаг SEEK_END указывают
как значение параметра whence
.
whence
Параметр whence
принимает следующие значения:
SEEK_SET
— Перемещает указатель в положение,
равное количеству байтов смещения offset
от начала файла.
SEEK_CUR
— Перемещает указатель вперёд — в положение,
равное количеству байтов смещения offset
от текущей позиции.
SEEK_END
— Перемещает указатель за пределы конца файла — в положение,
равное количеству байтов смещения offset
от конца файла.
Метод будет работать в режиме SEEK_SET
,
если параметр whence
не указали.
Метод возвращает 0 при успешном перемещении, иначе -1. Обратите внимание, что метод не считает ошибкой перемещение за пределы файла.
Пример #1 Пример использования метода SplFileObject::fseek()
<?php
$file = new SplFileObject("somefile.txt");
// Считываем первую строку
$data = $file->fgets();
// Перемещаемся в начало файла
// То же, что и вызов метода $file->rewind();
$file->fseek(0);
?>