fseek

(PHP 3, PHP 4)

fseek - ищет позицию указателя файла.

Описание

int fseek (int fp, int offset [, int whence])

Устанавливает индикатор позиции указателя файла, на который ссылается fp. Новая позиция высчитанная в байтах от начала файла, получается путём прибавления смещения offset к позиции, специфицированной параметром whence, значения которого определены так:

SEEK_SET - Установить позицию, равной смещению offset байтов.

SEEK_CUR - Установить позицию - текущее положение плюс offset.

SEEK_END - Установить позицию - end-of-file плюс offset. (Чтобы поместить позицию перед end-of-file, необходимо передать в offset отрицательное значение.)

Если whence не специфицирован, принимается значение SEEK_SET.

При успехе возвращает 0; иначе возвращает -1. Обратите внимание, что поиск после EOF не считается ошибкой.

Не может использоваться с файловыми указателями, возвращаемыми функцией fopen(), если они используют форматы "http://" или "ftp://".

Примечание: аргумент whence был введён после PHP 4.0.0.

См. также ftell() и rewind().