|queue||Pointer to a queue to retrieve characters from.|
|string||Pointer to a
|maxSize||Indicates the maximum number of
The number (count) of characters available in the queue.
Use this function to retrieve a copy of all the characters in a processing queue, including characters that have been entered but not yet processed.
The area pointed to by string should be big enough to hold
If string ==
NULL or if maxSize == 0, then the function only returns the number of characters that are available to be copied.
With only dead-key processing enabled, there can be a maximum of one unprocessed character in the queue (a dead key or combining accent character). ALT+keypad keystrokes are not stored in the queue as characters, and cannot be retrieved as individual characters. With Romaji conversion, there may be up to 4 unprocessed characters in the queue.
This function does not dequeue the characters that are retrieved; it just gets a copy.
|Background||Do not call this function from the background.|
|Callbacks||Do not call this function from any callback function.|
|Interrupt handler||Do not call this function from any interrupt handler.|
|Exception handler||Do not call this function from any exception handler.|
2013/05/08 Automated cleanup pass.