shmop_read
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
shmop_read — Читання даних з ділянки пам'яті, що розділяється
Опис
shmop_read(Shmop $shmop, int $offset, int $size): string
shmop_read() повертає рядкові дані, що зберігаються в ділянці пам'яті, що розділяється.
Список параметрів
shmop
Ресурс блоку пам'яті, що повертається функцією shmop_open()
offset
Усунення, з якого починається читання; повинно бути більше або дорівнює нулю і менше або дорівнює фактичному розміру сегмента пам'яті, що розділяється.
size
Кількість байтів для читання; має бути більше або дорівнює нулю, а сума offsetиsize повинна бути меншою або дорівнює фактичному розміру сегмента пам'яті, що розділяється . зчитує байти shmop_size($shmid) - $start
Значення, що повертаються
Повертає строкові дані або **false**в случае возникновения ошибки.
Помилки
Якщо параметр offsetилиsize знаходяться поза допустимим діапазоном, викидається виняток ValueError
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Параметрshmop чекає на екземпляр Shmop; раніше очікували ресурс (resource). |
| 8.0.0 | Якщо параметр offsetилиsize знаходяться поза допустимим діапазоном, викидається виняток ValueError; раніше видавалася помилка рівня E_WARNING та функція повертала значення false |
Приклади
Приклад #1 Читання даних з ділянки пам'яті, що розділяється
У наведеному прикладі виконується читання 50 байт з ділянки пам'яті, що розділяється (ідентифікується по $shm_id) та розміщення в $shm_data
Дивіться також
- shmop_write() - Запис даних у пам'ять, що розділяється