shmop_write
En esta página
shmop_write
Escribir en un bloque de memoria compartida
Descripción#
shmop_write(Shmop $shmop, string $data, int $offset): int
```php
`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
Escribe un bloque de memoria compartida
```php
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.
Véase también#
shmop_read