SAMConnection->peek()

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

SAMConnection->peek() — Lit un message depuis la file d'attente sans l'effacer

Description

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

Liste de paramètres

target

L'identité de la file d'attente depuis laquelle on lit le message.

properties

Un tableau associatif optionnel de propriétés décrivant les autres paramètres pour contrôler l'opération.

Nom de la propriétéValeurs possibles
SAM_CORRELIDC'est l'identifiant de corrélation des messages à lire. Ceci est typiquement retourné par la demande "send".
SAM_MESSAGEIDC'est l'identifiant du message à lire.

Valeurs de retour

Cette méthode retourne un objet SAMMessage ou FALSE si une erreur survient.

Exemples

Exemple 2287. Récupération du prochain message depuis la file d'attente sans l'effacer

<?php
$msg 
$conn->peek('queue://receive/test');

if (!
$msg) {
  
// Échec de la lecture !
  
echo "Échec de la lecture : ($conn->errno) $conn->error";
}
?>

Exemple 2288. Récupération d'un message spécifique depuis la file d'attente sans l'effacer

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

Voir aussi

SAMConnection->peekAll()