(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
.