X-Hacker.org- FORCE Data Base Compiler - ##############################################################################

Click above to get retro games delivered to your door ever month! X-Hacker.org- FORCE Data Base Compiler - ##############################################################################

[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]

##############################################################################
###+------+###################################################################
#+-| WAIT |------------------------------------------+########################
#| +------+ The WAIT command displays an optional or |########################
#|          default prompt and allows for character  |########################
#|          input assigned to a character variable   |########################
#+---------------------------------------------------+########################
##############################################################################
##############################################################################
#+--| Syntax |-------------------------+######################################
#|     WAIT [<C-exp>] [TO <C-var>]     |######################################
#+-------------------------------------+######################################
##############################################################################
##############################################################################
#########+---| Description |---------------------------------------+##########
#########| WAIT accepts one key from the keyboard.                 |##########
#########| ------------------------------------------------------- |##########
#########| A carriage return is printed before the prompt and/or   |##########
#########| keyboard input unless the variable __cr_first is set    |##########
#########| to FALSE.  The carriage return and optional or default  |##########
#########| prompt are displayed through the same I/O system as     |##########
#########| the ? command.                                          |##########
#########| ------------------------------------------------------- |##########
#########| <C-exp>                                                 |##########
#########|                                                         |##########
#########| If <C-exp> is specified, then it will replace the       |##########
#########| default prompt.  Otherwise, the message "Press any key  |##########
#########| to continue . . ." will be displayed.                   |##########
#########| ------------------------------------------------------- |##########
#########| TO <C-var>                                              |##########
#########|                                                         |##########
#########| If TO <C-var> is defined, then WAIT will assign the     |##########
#########| keystroke to <C-var>, unless the key is escape.  If     |##########
#########| either enter, tab or backspace keys terminate the       |##########
#########| WAIT command, their ASCII values are placed in <C-val>. |##########
#########+---------------------------------------------------------+##########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Pause to see if the user chooses to continue        |#########
#########|                                                          |#########
#########| WAIT "Do you wish to continue? " TO input_var            |#########
#########| IF input_var $ "Yy"                                      |#########
#########|     LOOP                                                 |#########
#########| ELSE                                                     |#########
#########|     RETURN                                               |#########
#########| ENDIF                                                    |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Pause the program without echoing to the screen.    |#########
#########|                                                          |#########
#########| SET CONSOLE OFF                                          |#########
#########| WAIT                                                     |#########
#########| RETURN                                                   |#########
#########+----------------------------------------------------------+#########
##############################################################################

See Also: ACCEPT INPUT inkey() lastkey()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson