(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
shmop_read — Liest Daten aus einem gemeinsamen Speicherbereich
shmop_read() liest einen String aus einem gemeinsam genutzten Speicherbereich.
shmop
Der Bezeichner für den gemeinsamen Speicherbereich, der von shmop_open() erzeugt wurde.
offset
Offset, bei dem der Lesevorgang beginnen soll; muss größer oder gleich Null und kleiner oder gleich der tatsächlichen Größe des gemeinsamen Speicherbereichs sein.
size
Die Anzahl der zu lesenden Bytes; muss größer oder gleich Null sein und
die Summe von offset
und
size
muss kleiner oder gleich der tatsächlichen
Größe des gemeinsamen Speicherbereichs sein. 0
liest
shmop_size($shmid) - $start
Bytes.
Gibt die gelesenen Daten zurück. Bei einem Fehler wird false
zurückgegeben.
Wenn offset
oder size
außerhalb des zulässigen Bereichs liegen, wird ein
ValueError ausgelöst.
Version | Beschreibung |
---|---|
8.0.0 |
shmop erwartet nun eine
Shmop-Instanz; vorher wurde eine
resource erwartet.
|
8.0.0 |
Wenn offset oder size
außerhalb des zulässigen Bereichs liegen, wird ein
ValueError ausgelöst; vorher wurde ein
E_WARNING ausgegeben und false zurückgegeben,
|
Beispiel #1 Aus dem gemeinsamen Speicherbereich lesen
<?php
$shm_data = shmop_read($shm_id, 0, 50);
?>
In diesem Beispiel werden 50 Bytes aus dem gemeinsamen Speicherbereich in
die Variable $shm_data
eingelesen.