shmop_read

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

shmop_readLiest Daten aus einem gemeinsamen Speicherbereich

Beschreibung

shmop_read(Shmop $shmop, int $offset, int $size): string

shmop_read() liest einen String aus einem gemeinsam genutzten Speicherbereich.

Parameter-Liste

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.

Rückgabewerte

Gibt die gelesenen Daten zurück. Bei einem Fehler wird false zurückgegeben.

Fehler/Exceptions

Wenn offset oder size außerhalb des zulässigen Bereichs liegen, wird ein ValueError ausgelöst.

Changelog

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,

Beispiele

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.

Siehe auch

  • shmop_write() - Schreibt Daten in einen gemeinsamen Speicherbereich