shmop_write

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

shmop_write — Escribir en un bloque de memoria compartida

Descripción

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

shmop_write() escribe una cadena en un bloque de memoria compartida.

Parámetros

shmop
El identificador del bloque de memoria compartida, creado por la función shmop_open()
data
Una cadena para escribir en el bloque de la memoria compartida
offset
Especifica la posición desde la cual los datos deben ser escritos en la memoria compartida. El offset debe ser superior o igual a cero e inferior o igual al tamaño real del segmento de memoria compartida.

Valores devueltos

El tamaño de los datos escritos.

Errores/Excepciones

Si offset está fuera de límite, o si un segmento de memoria compartida de solo lectura debe ser escrito, se levanta una ValueError.

Historial de cambios

Versión Descripción
8.0.0 Anterior a PHP 8.0.0, false era devuelto en caso de fallo.
8.0.0 shmop espera ahora una instancia de Shmop; anteriormente se esperaba un resource.

Ejemplos

Ejemplo #1 Escribe un bloque de memoria compartida

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

Este ejemplo escribe los datos de la cadena $my_string en un bloque de memoria compartida. $shm_bytes_written representará el número de bytes escritos.

Ver también