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);

?>

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

  • fseek() - Устанавливает смещение в файловом указателе

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top