Руководство по PHP
Пред. |  | След.

# 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().

Пред. | Начало | След.
fscanf | Уровень выше | fstat