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