SAMConnection::peek
Lectura de un mensaje de una cola sin eliminarlo de la cola.
&reftitle.description;
SAMMessageSAMConnection::peek
stringtarget
arrayproperties
&reftitle.parameters;
target
La identidad de la cola de la cual se va a leer el mensaje.
properties
Un array asociativo opcional de propiedades, que describen otros
parámetros para controlar la operación de lectura.
Nombre de la propiedad
Valores posibles
SAM_CORRELID
Este es el identificador de correlación del mensaje.
Es retornado típicamente por una petición "send".
SAM_MESSAGEID
Este es el identificador del mensaje que va a ser
leído.
&reftitle.returnvalues;
Este método devuelve un objeto SAMMessage o &false; en caso de error.
&reftitle.examples;
Obtener el próximo mensaje de una cola sin eliminarlo de la cola
peek('queue://receive/test');
if (!$msg) {
// The peek failed!
echo "Peek failed ($conn->errno) $conn->error";
}
?>
]]>
Obtener un mensaje específico de la cola sin eliminarlo de la cola
peek('queue://receive/test', array(SAM_MESSAGEID => $messageId));
?>
]]>
&reftitle.seealso;