array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'splfileobject.fseek.php', 1 => 'SplFileObject::fseek', 2 => 'Перемещает положение файлового указателя', ), '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', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SplFileObject::fseek

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

SplFileObject::fseek — Перемещает положение файлового указателя

Описание

public SplFileObject::fseek(int $offset, int $whence = SEEK_SET): int

Метод перемещает положение указателя в файле на позицию, которую получает путём прибавления смещения 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);

?>

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