# shmop_write

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

shmop_write — Écrire dans un bloc de mémoire partagée

### Description

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

shmop_write() écrit une chaîne dans un bloc de mémoire partagée.

### Liste de paramètres

`shmop`

  L'identifiant du bloc mémoire partagé, créé par la fonction shmop_open()

`data`

  Une chaîne à écrire dans le bloc de la mémoire partagée

`offset`

  Spécifie la position à partir de laquelle les données doivent être écrites dans la mémoire partagée. L'offset doit être supérieur ou égal à zéro et inférieur ou égal à la taille réelle du segment de mémoire partagée.

### Valeurs de retour

La taille des données écrites.

### Erreurs / Exceptions

Si `offset` est hors limite, ou si un segment de mémoire partagée en lecture seule doit être écrit, une ValueError est levée.

### Historique

Version | Description
--- | ---
8.0.0 | Antérieur à PHP 8.0.0, `false` était retourné en cas d'échec.
8.0.0 | `shmop` attend une instance de Shmop désormais; auparavant une resource était attendu.

### Exemples

Exemple #1 Écrit un bloc de mémoire partagée

`<?php
$shm_bytes_written = shmop_write($shm_id, $my_string, 0);
?>`

Cet exemple écrit les données de la chaîne `$my_string` dans un bloc de mémoire partagée. `$shm_bytes_written` représentera le nombre d'octets écrits.

### Voir aussi

- shmop_read() - Lit des données à partir d'un bloc