Manual do PHP
Anterior |  | Próxima

# SAMConnection->peek()

(no version information, might be only in CVS)

SAMConnection->peek() -- Read a message from a queue without removing it from the queue.

## Descrição

class SAMConnection {
SAMMessage peek ( string target [, array properties] )
}

## Parâmetros

`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.

## Valores de retornado

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

## Exemplos

Exemplo 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"; } ?>`

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

## Veja também

SAMConnection->peekAll()

Anterior | Principal | Próxima
SAMConnection->isConnected() | Acima | SAMConnection->peekAll()