shmop_read

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

shmop_readLê dados do bloco de memória compartilhada

Descrição

shmop_read(Shmop $shmop, int $offset, int $size): string

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 e size 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.

Veja Também

  • shmop_write() - Escreve dados em um bloco de memória compartilhada