133 of 318
ZBasic System Library 123 ZX Microcontroller Family GetQueueStr Type Function returning String Invocation GetQueueStr(queue) or GetQueueStr(queue, maxChars) Parameter Method Type Description queue ByRef array of Byte The queue of interest. maxChars ByVal integral The maximum number of characters to retrieve. Discussion This function extracts a number of characters from the specified queue and returns a string populated with those characters. The number of characters is limited to the lesser of 1) the number of characters in the queue at the time of the call, 2) the value of maxChars (if specified), and 3) the maximum number of characters allowed in a string. Note that before any queue operations are performed, the queue data structure must be initialized. See the discussion of OpenQueue() for more details. Also, attempting to retrieve data from a queue that has been assigned to a Com port as the transmit queue will produce undefined results. Compatibility This function is not available in BasicX compatibility mode. See Also GetQueue, OpenQueue