Messages and Message Lists (QSMM Programmer Manual)

Next: Exchanging Data Packets in a Multithreaded Program [Experimental], Previous: Ordinary and Sparse Vectors, Up: Miscellaneous Topics [Contents][Index]

6.3 Messages and Message Lists ¶

QSMM uses message lists to return error, warning, and note messages as part of a result of the following operations:

loading a memory representation of an assembler program into a node;
parsing the source text of an assembler program;
preprocessing the source text of an assembler program;
access to statistics storage.

Besides that, you can use the Message List API to return lists of messages from functions you develop.

A handle of qsmm_msglist_t type refers to a message list. A handle of qsmm_msg_t type refers to an individual message. The function qsmm_msglist_create creates an empty message list. You pass an empty message list to an API function that can fill it with messages. The function qsmm_msglist_dump dumps all messages in a message list to a stream. After using a message list, you destroy it by the function qsmm_msglist_destroy.