(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
shmop_read — Чтение данных из участка разделяемой памяти
shmop_read() возвращает строковые данные, хранимые в участке разделяемой памяти.
shmop
Ресурс блока памяти, возвращаемый функцией shmop_open()
offset
Смещение, с которого начинается чтение; должно быть больше или равно нулю и меньше или равно фактическому размеру сегмента разделяемой памяти.
size
Количество байтов для чтения; должно быть больше или равно нулю, а сумма offset
и size
должна быть меньше или равна фактическому размеру сегмента разделяемой памяти. 0
считывает байты shmop_size($shmid) - $start
.
Возвращает строковые данные или false
, если возникла ошибка.
Если параметр offset
или size
находятся вне допустимого диапазона, выбрасывается исключение ValueError.
Версия | Описание |
---|---|
8.0.0 | Параметр shmop ожидает экземпляр Shmop; ранее ожидался ресурс (resource). |
8.0.0 | Если параметр offset или size находятся вне допустимого диапазона, выбрасывается исключение ValueError; ранее выдавалась ошибка уровня E_WARNING и функция возвращала значение false . |
Пример #1 Чтение данных из участка разделяемой памяти
<?php
$shm_data = shmop_read($shm_id, 0, 50);
?>
В приведённом примере выполняется чтение 50 байт из участка разделяемой памяти (идентифицируемого по $shm_id
) и размещение в $shm_data
.