shmop_read

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

shmop_readLiest Daten aus einem gemeinsam genutzten Speicherbereich

Beschreibung

string shmop_read ( resource $shmid , int $start , int $count )

shmop_read() liest einen String aus einem gemeinsam genutzten Speicherblock.

Parameter-Liste

shmid

Der Bezeichner für den gemeinsamen Speicherblock, der von shmop_open() erzeugt wurde.

start

Offset, bei dem der Lesevorgang beginnen soll

count

Die Anzahl der zu lesenden Bytes

Rückgabewerte

Gibt die gelesenen Daten zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version Beschreibung
7.0.0 Der Typ von shmid wurde von int zu resource geändert.

Beispiele

Beispiel #1 Aus dem gemeinsamen Speicher lesen

<?php
$shm_data 
shmop_read($shm_id050);
?>

In diesem Beispiel werden 50 Bytes aus dem gemeinsamen Speicherblock in die Variable $shm_data eingelesen.

Siehe auch

  • shmop_write() - Schreibt Daten in einen gemeinsamen Speicherblock

add a note add a note

User Contributed Notes 4 notes

up
5
Craig Manley
13 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
2
macmaster at pobox dot com
17 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
0
slavapl at mailandnews dot com
16 years ago
Also you can use the shmop_size() function to determine the block size.
up
-15
Milan Cvejic
9 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