©
This document uses PHP Chinese website manual Release
(PHP 4 >= 4.0.4, PHP 5)
shmop_read — Read data from shared memory block
$shmid
, int $start
, int $count
)shmop_read() will read a string from shared memory block.
shmid
The shared memory block identifier created by shmop_open()
start
Offset from which to start reading
count
The number of bytes to read
Returns the data 或者在失败时返回 FALSE
.
Example #1 Reading shared memory block
<?php
$shm_data = shmop_read ( $shm_id , 0 , 50 );
?>
This example will read 50 bytes from shared memory block and place the data inside $shm_data.
[#1] Milan Cvejic [2009-02-18 13:35:11]
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));
?>
[#2] Craig Manley [2005-01-07 14:19:07]
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;
}
[#3] slavapl at mailandnews dot com [2001-05-02 12:15:33]
Also you can use the shmop_size() function to determine the block size.
[#4] macmaster at pobox dot com [2001-03-30 12:01:38]
When i need to read the whole string at that shm pointer, setting the count parameter to zero (0) seems work for me.