Документация PHP
| Документация DHTML | Документация Smarty | SVG/VML Графика и JavaScript
| Документация bash |
fseek
(PHP 4, PHP 5)
fseek — Устанавливает смещение в файловом указателе
Описание
int fseek ( resource $handle , int $offset [, int $whence ] )
Устанавливает смещение в файле, на который ссылается handle . Новое смещение, измеряемое в байтах от начала файла, получается путём прибавления параметра offset к позиции, указанной в параметре whence , значения которого определяются следующим образом:
- SEEK_SET - Устанавливает смещение в offset байт.
- SEEK_CUR - Устанавливает смещение в текущее плюс offset .
- SEEK_END - Устанавливает смещение в размер файла плюс offset . (Чтобы перейти к смещению перед концом файла, вы должны передать отрицательное значение в параметр offset .)
Если whence не указан, по умолчанию он устанавливается в SEEK_SET.
В случае успеха возвращает 0; в противном сучае возвращает -1. Обратите внимание, что переход к смещению за концом файла не считается ошибкой.
Пример #1 Пример использования функции fseek()
<?php
$fp = fopen('somefile.txt');
// читаем немного данных
$data = fgets($fp, 4096);
// перемещаемся назад к началу файла
// то же самое, что и rewind($fp);
fseek($fp, 0);
?>
Не может использоваться на файловых указателях, возвращённых функцией fopen(), если они используют форматы "http://" или "ftp://". fseek() также возвращает неопределённый результат для потоков "дописать в конец" (открытых с флагом "a").
Замечание: Параметр whence был добавлен в версии PHP 4.0.0.
См. также описание функций ftell() и rewind().