array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.shmop-read.php', 1 => 'shmop_read', ), 'up' => array ( 0 => 'ref.shmop.php', 1 => 'Shared Memory Funktionen', ), 'prev' => array ( 0 => 'function.shmop-open.php', 1 => 'shmop_open', ), 'next' => array ( 0 => 'function.shmop-size.php', 1 => 'shmop_size', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/shmop/functions/shmop-read.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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.