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