CascadiaPHP 2024

shmop_read

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

shmop_readLit des données à partir d'un bloc

Description

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

shmop_read() lit une chaîne dans un bloc de mémoire partagée.

Liste de paramètres

shmop

L'identifiant du bloc mémoire partagé, créé par la fonction shmop_open()

offset

Position depuis laquelle on doit commencer à lire; doit être supérieur ou égal à zéro et inférieur ou égal à la taille réelle du segment de mémoire partagée.

size

Le nombre d'octets à lire; doit être supérieur ou égal à zéro, et la somme de offset et size doit être inférieure ou égale à la taille réelle du segment de mémoire partagée. 0 lit shmop_size($shmid) - $start octets.

Valeurs de retour

Retourne les données ou false si une erreur survient.

Erreurs / Exceptions

Si offset ou size sont hors de l'intervalle, une ValueError est lancé.

Historique

Version Description
8.0.0 shmop attend une instance de Shmop désormais; auparavant une resource était attendu.
8.0.0 Si offset ou size sont hors limite, une ValueError est lancée ; auparavant, une E_WARNING était émise et false était retourné,

Exemples

Exemple #1 Lit un bloc de mémoire partagée

<?php
$shm_data
= shmop_read($shm_id, 0, 50);
?>

Cet exemple lit 50 octets dans le bloc de mémoire partagée et les place dans $shm_data.

Voir aussi

add a note

User Contributed Notes 5 notes

up
6
Craig Manley
19 years ago
shmop_read() reads and returns the whole memory segment's data. This is not useful if you're just working with strings. If you need to read a string from shared memory, call str_from_mem() on the result of shmop_read(). Similarly when writing strings to memory (instead of binary data), null terminate your strings with str_to_nts() before passing the value on to shmop_write().

function str_to_nts($value) {
return "$value\0";
}

function str_from_mem(&$value) {
$i = strpos($value, "\0");
if ($i === false) {
return $value;
}
$result = substr($value, 0, $i);
return $result;
}
up
3
macmaster at pobox dot com
23 years ago
When i need to read the whole string at that shm pointer, setting the count parameter to zero (0) seems work for me.
up
1
michael dot wuertz at six dot de
3 years ago
With shmop_read, you probably get a "\0" - padded string.

$zero_padded = shmop_read($shm_seg, 0, 128);

$usable_string = rtrim($zero_padded, "\0");
up
-1
slavapl at mailandnews dot com
23 years ago
Also you can use the shmop_size() function to determine the block size.
up
-22
Milan Cvejic
15 years ago
You should always serialize data written in shared memory.
And when you are reading data you should always unserialize.

<?php

$data
= 'test';
$shm_bytes_written = shmop_write($shm_id, serialize($data), 0);
$shm_data = unserialize(shmop_read($shm_id, 0, $shm_bytes_written));
?>
To Top