array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'splfileobject.fseek.php', 1 => 'SplFileObject::fseek', ), 'up' => array ( 0 => 'class.splfileobject.php', 1 => 'SplFileObject', ), 'prev' => array ( 0 => 'splfileobject.fscanf.php', 1 => 'SplFileObject::fscanf', ), 'next' => array ( 0 => 'splfileobject.fstat.php', 1 => 'SplFileObject::fstat', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/spl/splfileobject/fseek.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
SplFileObject::fseek — Перевод файлового указателя на заданную позицию
Перемещает файловый указатель на указанное в параметре
offset
количество байт. За позицию, от которой будет
отсчитываться смещение отвечает параметр whence
.
offset
Смещение. Отрицательная величина смещения используется, когда нужно
перемещаться по файлу от конца к началу, т.е. когда в качестве аргумента
whence
передано значение SEEK_END.
whence
Возможные значения параметра whence
:
SEEK_SET
- Установить указатель на позицию
offset
байт от начала файла.SEEK_CUR
- Переместить указатель на
offset
байт относительно текущего положения.SEEK_END
- Установить указатель на позицию
offset
байт от конца файла.
Если параметр whence
опущен, функция будет работать в
режиме SEEK_SET
.
Возвращает 0, если перемещение прошло успешно, и -1 в противном случае. Следует помнить, что перемещение за конец файла не рассматривается как ошибка.
Пример #1 Пример использования SplFileObject::fseek()
<?php
$file = new SplFileObject("somefile.txt");
// Чтение первой строки
$data = $file->fgets();
// Перемещаемся снова в начало файла
// То же, что и $file->rewind();
$file->fseek(0);
?>