msg_send
Eviar un mensaje a una cola de mensajes
&reftitle.description;
boolmsg_send
resourcequeue
intmsgtype
mixedmessage
boolserializetrue
boolblockingtrue
interrorcode
msg_send envía un message del tipo
msgtype (DEBE ser mayor que 0) a
la cola de mensajes especificada por queue.
&reftitle.parameters;
queue
msgtype
message
serialize
El parámetro opcional serialize controla el modo de
enviar el mensaje dado por message. serialize
es por defecto &true; lo que significa que message es
serializado usando el mismo mecanismo que el módulo de sesión antes de ser
enviado a la cola. Esto permite matrices y objetos complejos para ser enviados a
otros scripts de PHP, o si se está usando el serializador WDDX, para cualquier
cliente compatible con WDDX.
blocking
Si el mensaje es demasiado largo para caber en la cola el script esperará
hasta que otro proceso lea los mensajes de la cola y libere sufieciente
espacio para el mensaje que se va a enviar.
Esto se llama bloqueo; se puede prevenir el bloqueo estableciendo el
parámetro blocking a &false;, en cuyo
caso msg_send devolverá inmediatamente &false; si el
mensaje es demasiado grande para la cola, y establecerá el parámetro opcional
errorcode a MSG_EAGAIN,
indicando que se debería intentar enviar el mensaje de nuevo un poco
más tarde.
errorcode
&reftitle.returnvalues;
&return.success;
Al finalizar con éxito, la estructura de datos de la cola de mensajes se actualiza como
sigue: msg_lspid se establece al ID del proceso de
llamada, msg_qnum se incrementa en 1 y
msg_stime se establece al momento actual.
&reftitle.seealso;
msg_remove_queue
msg_receive
msg_stat_queue
msg_set_queue