array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.shmop-read.php', 1 => 'shmop_read', 2 => 'Lee datos a partir de un bloque', ), 'up' => array ( 0 => 'ref.shmop.php', 1 => 'Funciones de memoria compartida', ), 'prev' => array ( 0 => 'function.shmop-open.php', 1 => 'shmop_open', ), 'next' => array ( 0 => 'function.shmop-size.php', 1 => 'shmop_size', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/shmop/functions/shmop-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

shmop_read

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

shmop_read — Lee datos a partir de un bloque

Descripción

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

shmop_read() lee una cadena en un bloque de memoria compartida.

Parámetros

shmop
El identificador del bloque de memoria compartida, creado por la función shmop_open()
offset
Posición desde la cual se debe comenzar a leer; debe ser superior o igual a cero e inferior o igual a la longitud real del segmento de memoria compartida.
size
El número de bytes a leer; debe ser superior o igual a cero, y la suma de offset y size debe ser inferior o igual a la longitud real del segmento de memoria compartida. 0 lee shmop_size($shmid) - $start bytes.

Valores devueltos

Devuelve los datos.

Errores/Excepciones

Si offset o size están fuera del rango, se lanza una ValueError.

Historial de cambios

Versión Descripción
8.0.0 shmop ahora requiere una instancia de Shmop en lugar de un resource.
8.0.0 Si offset o size están fuera de límite, se lanza una ValueError; anteriormente se emitía una E_WARNING y se devolvía false.

Ejemplos

Ejemplo #1 Lee un bloque de memoria compartida

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

Este ejemplo lee 50 bytes del bloque de memoria compartida y los coloca en $shm_data.

Ver también