Message Queue

This document introduces a set of functions about message queue. Message queue is only working in a coroutine group in the same thread.

There are two kinds of message: queue message and topic message.

Melang supports many coroutines to listen the same queue. If message is a queue message, only one coroutine can get this message. If is topic message, every subscribed coroutine can receive this message.

mln_msgTopicSubscribe

Subscribe a topic message.

@mln_msgTopicSubscribe(qname);

Input:

• qname - a string queue name.

Return value:

• Always return nil.

Error:

• Invalid argument will throw an error.

mln_msgTopicUnsubscribe

Unsubscribe a topic.

@mln_msgTopicUnsubscribe(qname);

Input:

• qname - a string queue name.

Return value:

• Always nil.

Error:

• Invalid argument will throw an error.

mln_msgQueueSend

Send message to a specified queue.

@mln_msgQueueSend(qname, msg, asTopic);

Input:

• qname - a string queue name.
• msg - the message that we want to send. The type of this argument must be integer, boolean, real or string.
• asTopic - if want to send queue message, this argument must be false, otherwise true. This is an optional argument. Omitted means false.

Return value:

• Always nil.

Error:

• Invalid argument will throw an error.

mln_msgQueueRecv

@smln_msgQueueRecv(qname, timeout);

Input:

• qname - a string queue name.
• timeout - a positive integer or nil. If is positive integer, program will wait for timeout microseconds. If omitted or nil, prigram will wait until got a message.

Return value:

• A message.

Error:

• Invalid argument will throw an error.

Example

//file a.mln
@mln_msgQueueSend('test', 'hello');

//b.mln
msg = @mln_msgQueueRecv('test');
@mln_print(msg);

$ melang a.mln b.mln

The output is:

hello