Описание
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().