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() - Встановлює зміщення у файловому покажчику