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

VersionDescription
8.0.0shmop 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

To Top