(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_seek() вызывается метод streamWrapper::stream_tell(). Значение
falseустанавливается как значение возврата функции, которая вызвала этот метод, если метод streamWrapper::stream_tell() завершится ошибкой.
Замечание:
Не каждая операция перемещения указателя в потоке вызывает этот метод. PHP-потоки по умолчанию буферизируют считывание (смотрите также описание функции stream_set_read_buffer()), поэтому перемещение указателя иногда завершается простым перемещением указателя буфера.