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