SAMConnection->peek()
(no version information, might be only in CVS)
SAMConnection->peek() --
Read a message from a queue without removing it from the queue.
Description
class
SAMConnection {
SAMMessage
peek ( string target [, array properties] )
}
Parameters
target
The identity of the queue from which to peek the message.
properties
An optional associative array of properties describing other
parameters to control the peek operation.
Return Values
This method returns a SAMMessage object or FALSE if an error occurs.
Examples
Example 1. Retrieve the next message from a queue without removing it
<?php
$msg = $conn->peek('queue://receive/test');
if (!$msg) {
// The peek failed!
echo "Peek failed ($conn->errno) $conn->error";
}
?>
|
|
Example 2. Retrieve a specific message from a queue without removing it from the queue
<?php
$msg = $conn->peek('queue://receive/test', array(SAM_MESSAGEID => $messageId));
?>
|
|