(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
shmop_write — Schreibt Daten in einen gemeinsamen Speicherbereich
shmop_write() schreibt Daten in einen gemeinsamen Speicherbereich.
shmop
Der Bezeichner für den gemeinsamen Speicherbereich, der von shmop_open() erzeugt wurde.
data
Ein String, der in den gemeinsamen Speicherbereich geschrieben werden soll.
offset
Gibt an, von welcher Position ab Daten in den gemeinsamen Speicherbereich geschrieben werden sollen. Der Offset muss größer oder gleich Null und kleiner oder gleich der tatsächlichen Größe des gemeinsamen Speicherbereichs sein.
Die Länge der geschriebenen Daten data
oder false
, falls ein Fehler auftrat.
Wenn offset
außerhalb des zulässigen Bereichs liegt oder in einen schreibgeschützten gemeinsamen Speicherbereich geschrieben werden soll, wird ein ValueError ausgelöst.
Version | Beschreibung |
---|---|
8.0.0 | Vor PHP 8.0.0 wurde bei einem Fehler false zurückgegeben. |
8.0.0 | shmop erwartet nun eine Shmop-Instanz; vorher wurde eine resource erwartet. |
Beispiel #1 In den gemeinsamen Speicherbereich schreiben
<?php
$shm_bytes_written = shmop_write($shm_id, $my_string, 0);
?>
In diesem Beispiel werden die Daten der Variablen $my_string
in den gemeinsamen Speicherbereich geschrieben. Die Variable $shm_bytes_written
enthält die Anzahl der geschriebenen Bytes.