Delicious Bookmark this on Delicious Share on Facebook SlashdotSlashdot It! Digg! Digg



PHP : Function Reference : SAM - Simple Asynchronous Messaging : SAMConnection->peek()

SAMConnection->peek()

Read a message from a queue without removing it from the queue. ()

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.

Property name Possible values
SAM_CORRELID This is the target correlation id string of the message. This would typically have been returned by a "send" request.
SAM_MESSAGEID This is the message id string of the message which is to be peeked.

Return Values

This method returns a SAMMessage object or FALSE if an error occurs.

Examples

Example 2118. 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 2119. Retrieve a specific message from a queue without removing it from the queue

<?php

$msg
= $conn->peek('queue://receive/test', array(SAM_MESSAGEID => $messageId));

?>


Change Language


Follow Navioo On Twitter
SAMConnection->commit()
SAMConnection->connect()
SAMConnection->__construct()
SAMConnection->disconnect()
SAMConnection->errno
SAMConnection->error
SAMConnection->isConnected()
SAMConnection->peek()
SAMConnection->peekAll()
SAMConnection->receive()
SAMConnection->remove()
SAMConnection->rollback()
SAMConnection->send()
SAMConnection::setDebug()
SAMConnection->subscribe()
SAMConnection->unsubscribe()
SAMMessage->body
SAMMessage->__construct()
SAMMessage->header
eXTReMe Tracker