array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'streamwrapper.stream-seek.php', 1 => 'streamWrapper::stream_seek', 2 => 'Перемещает положение файлового указателя в потоке', ), 'up' => array ( 0 => 'class.streamwrapper.php', 1 => 'streamWrapper', ), 'prev' => array ( 0 => 'streamwrapper.stream-read.php', 1 => 'streamWrapper::stream_read', ), 'next' => array ( 0 => 'streamwrapper.stream-set-option.php', 1 => 'streamWrapper::stream_set_option', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/stream/streamwrapper/stream-seek.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

streamWrapper::stream_seek

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_seek — Перемещает положение файлового указателя в потоке

Описание

public streamWrapper::stream_seek(int $offset, int $whence): bool

Метод вызывается в ответ на функцию fseek().

Позиция потока, с которой данные начнут считываться или записываться в поток, обновляется с учётом смещения offset и значения параметра whence, от которого отсчитывается смещение.

Список параметров

offset

Смещение в потоке, на которое переместится указатель.

whence

Доступные значения:

  • SEEK_SET — Перемещает указатель в положение, равное количеству байтов смещения offset от начала файла.
  • SEEK_CUR — Перемещает указатель вперёд — в положение, равное количеству байтов смещения offset от текущей позиции.
  • SEEK_END — Перемещает указатель за пределы конца файла — в положение, равное количеству байтов смещения offset от конца файла.

Замечание: Текущая реализация метода не устанавливает для параметра whence значение SEEK_CUR; вместо перемещения указателя от текущей позиции перемещение внутренне преобразовывается в режим SEEK_SET.

Возвращаемые значения

Метод возвращает значение true, если обновил позицию указателя, иначе возвращает значение false.

Примечания

Замечание:

Значение false предполагается как значение возврата, если метод не реализовали.

Замечание:

Сразу после успешного вызова метода streamWrapper::stream_seek() вызывается метод streamWrapper::stream_tell(). Значение false устанавливается как значение возврата функции, которая вызвала этот метод, если метод streamWrapper::stream_tell() завершится ошибкой.

Замечание:

Не каждая операция перемещения указателя в потоке вызывает этот метод. PHP-потоки по умолчанию буферизируют считывание (смотрите также описание функции stream_set_read_buffer()), поэтому перемещение указателя иногда завершается простым перемещением указателя буфера.

Смотрите также