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  = SEEK_SET): 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_tell() буде викликано відразу після того, як streamWrapper::stream_seek() відпрацює. Якщо виконання streamWrapper::stream_tell() завершиться невдачею, то викликаючу функцію буде повернуто значення false

Зауваження :

Не всі операції переміщення у потоці призведуть до виклику цієї функції. У PHP за замовчуванням включено буферизацію потоків (дивіться також stream_set_read_buffer()), тому переміщення в потоці може означати лише переміщення покажчика буфері.

Дивіться також

  • fseek() - Встановлює зміщення у файловому покажчику