CMS AP-Fusion - движок для вашего сайта

fseek

(PHP 3, 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().

Все функции PHP: