shmop_read
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
shmop_read — Lê dados do bloco de memória compartilhada
Descrição
shmop_read() lê uma string do bloco de memória compartilhada.
Parâmetros
shmop
-
O identificador do bloco de memória compartilhada criado por shmop_open()
offset
-
Posição a partir da qual a leitura será iniciada; deve ser maior ou igual a zero e menor ou igual ao tamanho real do segmento de memória compartilhada.
size
-
O número de bytes a serem lidos; deve ser maior ou igual a zero e a soma de
offset
esize
deve ser menor ou igual ao tamanho real do segmento de memória compartilhada.0
significa que a função leráshmop_size($shmid) - $start
bytes.
Valor Retornado
Retorna os dados ou false
em caso de falha.
Erros/Exceções
Se offset
ou size
estiverem fora do intervalo,
um ValueError é lançado.
Registro de Alterações
Versão | Descrição |
---|---|
8.0.0 |
shmop agora espera uma instância de Shmop;
anteriormente, esperava um resource.
|
8.0.0 |
Se offset ou size estiverem fora do intervalo,
um ValueError é lançado; anteriormente, um E_WARNING
era emitido e false era retornado.
|
Exemplos
Example #1 Lendo bloco de memória compartilhada
<?php
$shm_data = shmop_read($shm_id, 0, 50);
?>
Este exemplo irá ler 50 bytes do bloco de memória compartilhada e colocar os dados
dentro de $shm_data
.