streamWrapper::stream_seek - Перемещение на заданную позицию в потоке
Вернуться к: streamWrapper
streamWrapper::stream_seek
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
streamWrapper::stream_seek — Перемещение на заданную позицию в потоке
Описание
$offset
, int $whence
= SEEK_SET
)Этот метод вызывается в результате вызова функции fseek().
Позицию чтения/записи в потоке необходимо обновлять в соответствии с
аргументами offset
и whence
.
Список параметров
-
offset
-
Смещение в потоке, на которое требуется переместиться.
-
whence
-
Возможные значения:
-
SEEK_SET
- Переместиться на позициюoffset
байт от начала файла. -
SEEK_CUR
- Переместиться наoffset
байт относительно текущей позиции. -
SEEK_END
- Переместиться на позициюoffset
байт от конца файла.
-
Возвращаемые значения
Возвращает TRUE
, если позиция обновлена, FALSE
в остальных случаях.
Примечания
Замечание:
Если не реализован, в качестве возвращаемого значения принимается
FALSE
.
Замечание:
В случае успеха streamWrapper::stream_tell() будет вызвана сразу после того, как streamWrapper::stream_seek() отработает. Если выполнение streamWrapper::stream_tell() завершится неудачей, то в вызывающую функцию будет возвращено значение
FALSE
Замечание:
Не все операции перемещения в потоке приведут к вызову этой функции. В PHP по умолчанию включена буферизация потоков (см. также stream_set_read_buffer()), поэтому перемещение в потоке может означать лишь перемещение указателя в буфере.
Вернуться к: streamWrapper