shmop_read

(PHP 4 >= 4.0.4, PHP 5)

shmop_read — 共有メモリブロックからデータを読み込む

説明

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

shmop_read() は共有メモリブロックから文字列を読み込みます。

パラメータ

shmid: shmop_open() が作成した共有メモリブロックの識別子。
start: 読み込みを開始する位置。
count: 読み込むバイト数。

返り値

データ、あるいは失敗した場合に FALSE を返します。

例

例1 共有メモリブロックを読み込む


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

この例は共有メモリブロックから 50 バイトを読み込んで、 $shm_data の中のデータに置くものです。

参考

shmop_write() - 共有メモリブロックにデータを書き込む

shmop_size

shmop_open

Last updated: Fri, 13 Nov 2009

add a note User Contributed Notes
shmop_read

Milan Cvejic
18-Feb-2009 09:35


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));

?>

Craig Manley
07-Jan-2005 10:19


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;

}

slavapl at mailandnews dot com
02-May-2001 07:15


Also you can use the shmop_size() function to determine the block size.

macmaster at pobox dot com
30-Mar-2001 08:01


When i need to read the whole string at that shm pointer, setting the count parameter to zero (0) seems work for me.

add a note

shmop_size

shmop_open

Last updated: Fri, 13 Nov 2009