shmop_write
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
shmop_write — Escreve dados em um bloco de memória compartilhada
Descrição
shmop_write() escreve uma string em um bloco de memória compartilhada.
Parâmetros
shmop-
O identificador do bloco de memória compartilhada criado por shmop_open().
data-
Uma string a ser escrita em um bloco de memória compartilhada.
offset-
Posição onde se deve iniciar a escrita de dados dentro do segmento de memória compartilhada. A posição deve ser maior ou igual a zero e menor ou igual ao tamanho real do segmento de memória compartilhada.
Valor Retornado
O tamanho dos dados do parâmetro data escritos.
Erros/Exceções
Se offset estiver fora do intervalo, ou se houver tentativa de escrita em um
segmento de memória compartilhada somente-leitura, um ValueError é lançado.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.0.0 |
Antes do PHP 8.0.0, false era retornado em caso de falha.
|
| 8.0.0 |
shmop agora espera uma instância de Shmop;
anteriormente, esperava um resource.
|
Exemplos
Example #1 Escrevendo no bloco de memória compartilhada
<?php
$shm_bytes_written = shmop_write($shm_id, $my_string, 0);
?>
Esse exemplo irá escrever dados dentro de $my_string em
um bloco de memória compartilhada, $shm_bytes_written conterá
o número de bytes escritos.