downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | my php.net 
search for in the  

<SAMConnection->peek()SAMConnection->receive()>
Last updated: Thu, 26 Jun 2008

SAMConnection->peekAll()

(No version information available, might be only in CVS)

SAMConnection->peekAll() — Read one or more messages from a queue without removing it from the queue.

Description

SAMConnection
array peekAll ( string $target [, array $properties ] )

Parameters

target

The identity of the queue from which messages should be peeked.

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 messages to be peeked. This would typically have been returned by a "send" request.
SAM_MESSAGEID This is the message id string of a message which is to be peeked.

Return Values

This method returns an array of SAMMessage objects or FALSE if an error occurs.

Examples

Example #1 Retrieve all messages in a queue without removing them

<?php
$msgArray
= $conn->peekAll('queue://receive/test');
if (
$msgArray) {
   foreach (
$msgArray as $key => $msg) {
       echo
"Message $key: body = $msg->body\n";
   }
} else {
   echo
"PeekAll failed ($conn->errno) $conn->error";
}
?>

Example #2 Retrieve all messages from a queue with a matching correlation id

<?php

   $msgArray
= $conn->peekAll('queue://receive/test', array(SAM_CORRELID => $correlId ));
   if (
$msgArray) {

     foreach (
$msgArray as $key => $msg) {
           echo
"Message $key: body = $msg->body\n";
         }
     }
   else
     echo
"PeekAll failed ($conn->errno) $conn->error";
   }

?>



add a noteadd a note User Contributed Notes
Read one or more messages from a queue without removing it from the queue.
There are no user contributed notes for this page.




<SAMConnection->peek()SAMConnection->receive()>
Last updated: Thu, 26 Jun 2008
show source | credits | sitemap | contact | advertising | mirror sites
Copyright © 2001-2005 The PHP Group
All rights reserved.
This unofficial mirror is operated at: http://phpbuilder.com/
Last updated: Tue Nov 1 20:20:59 2005 EST
Columns / Articles | Tips / Quickies | News | News Linking and RSS Feeds | Shared Code Library
Mail Archives | Support / Discussion Forums | Get Started! Links | Contribute! | Docs