SplFileObject::fseek - Перевод файлового указателя на заданную позицию
Вернуться к: SplFileObject
SplFileObject::fseek
(PHP 5 >= 5.1.0, PHP 7)
SplFileObject::fseek — Перевод файлового указателя на заданную позицию
Описание
$offset
[, int $whence
= SEEK_SET
] )
Перемещает файловый указатель на указанное в параметре
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 SplFileInfo("somefile.txt");
// Чтение первой строки
$data = $file->fgets();
// Перемещаемся снова в начало файла
// смысл тот же, что и $file->rewind();
$file->fseek(0);
?>
Вернуться к: SplFileObject