##############################################################################
###+-----------+##############################################################
#+-| LASTKEY() |---------------------------------------------------+##########
#| +-----------+ Returns last key removed from the keyboard buffer |##########
#+-----------------------------------------------------------------+##########
##############################################################################
##############################################################################
#+--| Summary |------------+##################################################
#|     #INCLUDE io.hdr     |##################################################
#+-------------------------+##################################################
##############################################################################
##############################################################################
#+--| Syntax |-----------------------------+##################################
#|     FUNCTION UINT lastkey PROTOTYPE     |##################################
#+-----------------------------------------+##################################
##############################################################################
##############################################################################
###########+---| Description |------------------------------------+###########
###########| The lastkey() function returns the last key that was |###########
###########| removed from the keyboard buffer.                    |###########
###########+------------------------------------------------------+###########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Use lastkey() to check the terminating              |#########
#########| *    key of the READ command.                            |#########
#########|                                                          |#########
#########| READ                                                     |#########
#########| IF lastkey() = &K_ESC                                    |#########
#########|     RETURN                                               |#########
#########| ENDIF                                                    |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    GET allows the use of a keyboard filter.  Use       |#########
#########| *    lastkey() to retrieve the key in your GET           |#########
#########| *    keyboard filter routine.                            |#########
#########|                                                          |#########
#########| * This function provides an "upper" function.            |#########
#########| * This is identical to GET "@!"                          |#########
#########| FUNCTION INT keyboard_filter                             |#########
#########|     VARDEF                                               |#########
#########|         INT    k                                         |#########
#########|     ENDDEF                                               |#########
#########|                                                          |#########
#########|     k = lastkey()                                        |#########
#########|     IF k >= 'a' .AND. k =< 'z'                           |#########
#########|         k = k - 'a' + 'A'   && convert to upper case     |#########
#########|     ENDIF                                                |#########
#########|     RETURN k                                             |#########
#########| ENDPRO                                                   |#########
#########|                                                          |#########
#########|     *--- issue a GET that uses the above keyboard        |#########
#########|     *    filter function, keyboard_filter.               |#########
#########|                                                          |#########
#########|     @ 0,0 SAY "Using filter" GET char_var ;              |#########
#########|           FILTER keyboard_filter                         |#########
#########|     READ                                                 |#########
#########+----------------------------------------------------------+#########
##############################################################################