ZBasic System Library
154
ZBasic Microcontrollers
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
 |
 |
 |