DevConf 2015

shmop_read

(PHP 4 >= 4.0.4, PHP 5)

shmop_readLiest Daten aus einem gemeinsam genutzten Speicherbereich

Beschreibung

string shmop_read ( int $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.

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
3
Craig Manley
10 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
0
slavapl at mailandnews dot com
14 years ago
Also you can use the shmop_size() function to determine the block size.
up
0
macmaster at pobox dot com
14 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
-5
Milan Cvejic
6 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