# shmop_write

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

shmop_write — Schreibt Daten in einen gemeinsamen Speicherbereich

### Beschreibung

shmop_write(Shmop `$shmop`, string `$data`, int `$offset`): int

shmop_write() schreibt Daten in einen gemeinsamen Speicherbereich.

### Parameter-Liste

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

### Rückgabewerte

Die Länge der geschriebenen Daten `data` oder `false`, falls ein Fehler auftrat.

### Fehler/Exceptions

Wenn `offset` außerhalb des zulässigen Bereichs liegt oder in einen schreibgeschützten gemeinsamen Speicherbereich geschrieben werden soll, wird ein ValueError ausgelöst.

### Changelog

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.

### Beispiele

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.

### Siehe auch

- shmop_read() - Liest Daten aus einem gemeinsamen Speicherbereich

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open