get_message_queue_paramget_message_queue_paramGetMessageQueueParamget_message_queue_paramGetMessageQueueParamGetMessageQueueParam (Operator)

Name

get_message_queue_paramget_message_queue_paramGetMessageQueueParamget_message_queue_paramGetMessageQueueParamGetMessageQueueParam — Query message queue parameters or information about the queue.

Signature

get_message_queue_param( : : QueueHandle, GenParamName : GenParamValue)

get_message_queue_paramget_message_queue_paramGetMessageQueueParamget_message_queue_paramGetMessageQueueParamGetMessageQueueParam queries current values of message queue parameters or other information about the queue status.

Multiple queries can be carried out with a single get_message_queue_paramget_message_queue_paramGetMessageQueueParamget_message_queue_paramGetMessageQueueParamGetMessageQueueParam call, passing multiple parameter names to parameter GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName. The parameter values are returned in GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue in the same order as the parameter names requested by the caller.

Currently, following parameter names are supported:

'is_empty'"is_empty""is_empty""is_empty""is_empty""is_empty":

Returns 1 if the queue is empty, 0 otherwise.

'message_num'"message_num""message_num""message_num""message_num""message_num":

Returns the number of messages currently stored in the queue.

'max_message_num'"max_message_num""max_message_num""max_message_num""max_message_num""max_message_num":

Returns the current value of the 'max_message_num'"max_message_num""max_message_num""max_message_num""max_message_num""max_message_num" parameter of the message queue, as it was set using set_message_queue_paramset_message_queue_paramSetMessageQueueParamset_message_queue_paramSetMessageQueueParamSetMessageQueueParam. The default value -1 stands for no limit.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

QueueHandleQueueHandleQueueHandleQueueHandleQueueHandlequeueHandle (input_control) message_queue → (integer)

Message queue handle.

Number of elements: QueueHandle == 1

Restriction: QueueHandle != 0

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) string(-array) → (string)

Names of the queue parameters or info queries.

Number of elements: GenParamName == GenParamValue

Default value: 'max_message_num' "max_message_num" "max_message_num" "max_message_num" "max_message_num" "max_message_num"

List of values: 'is_empty'"is_empty""is_empty""is_empty""is_empty""is_empty", 'max_message_num'"max_message_num""max_message_num""max_message_num""max_message_num""max_message_num", 'message_num'"message_num""message_num""message_num""message_num""message_num"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (output_control) tuple(-array) → (string / integer / real)

Values of the queue parameters or info queries.

Number of elements: GenParamName == GenParamValue

Example (HDevelop)

create_message_queue (QueueHandle)
set_message_queue_param ( QueueHandle, 'max_message_num', 10)
* ...
get_message_queue_param( QueueHandle, 'message_num', Num)

Result

If all the operator parameters are valid, get_message_queue_paramget_message_queue_paramGetMessageQueueParamget_message_queue_paramGetMessageQueueParamGetMessageQueueParam returns 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

create_message_queuecreate_message_queueCreateMessageQueuecreate_message_queueCreateMessageQueueCreateMessageQueue, enqueue_messageenqueue_messageEnqueueMessageenqueue_messageEnqueueMessageEnqueueMessage, dequeue_messagedequeue_messageDequeueMessagedequeue_messageDequeueMessageDequeueMessage

create_message_queuecreate_message_queueCreateMessageQueuecreate_message_queueCreateMessageQueueCreateMessageQueue, clear_message_queueclear_message_queueClearMessageQueueclear_message_queueClearMessageQueueClearMessageQueue, enqueue_messageenqueue_messageEnqueueMessageenqueue_messageEnqueueMessageEnqueueMessage, dequeue_messagedequeue_messageDequeueMessagedequeue_messageDequeueMessageDequeueMessage, set_message_queue_paramset_message_queue_paramSetMessageQueueParamset_message_queue_paramSetMessageQueueParamSetMessageQueueParam, create_messagecreate_messageCreateMessagecreate_messageCreateMessageCreateMessage, clear_messageclear_messageClearMessageclear_messageClearMessageClearMessage, set_message_tupleset_message_tupleSetMessageTupleset_message_tupleSetMessageTupleSetMessageTuple, get_message_tupleget_message_tupleGetMessageTupleget_message_tupleGetMessageTupleGetMessageTuple, set_message_objset_message_objSetMessageObjset_message_objSetMessageObjSetMessageObj, get_message_objget_message_objGetMessageObjget_message_objGetMessageObjGetMessageObj

Module

Foundation

Operators