[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
WAIT*
Suspend program processing until a key is pressed
------------------------------------------------------------------------------
Syntax
WAIT [<expPrompt>] [TO <idVar>]
Arguments
<expPrompt> is an expression of any data type displayed as a prompt.
If no <expPrompt> is specified, the default prompt displayed is: "Press
any key to continue..."
TO <idVar> is the variable, of any storage class, that holds the
value of the key pressed as a character value. If <idVar> does not
exist or is not visible, it is created as a private variable and then
assigned the character value.
Description
WAIT is a console command and wait state that displays a prompt after
sending a carriage return/line feed to the screen. It then waits for
the user to press a key. If the TO clause is specified, <idVar> is
assigned the keystroke as a character value. If an Alt or Ctrl key is
pressed, WAIT assigns CHR(0) to <idVar>. Non-alphanumeric values
entered by pressing an Alt-keypad combination assign the specified
character. If the character can be displayed, it is echoed to the
screen. Function keys are ignored unless assigned with SET FUNCTION or
SET KEY.
WAIT is a compatibility command and, therefore, is not recommended for
general usage. It is superseded by both @...GET/READ and INKEY() for
getting single character input.
Notes
. WAITing without a prompt: To pause execution without
displaying a prompt, specify WAIT, null string (""), or INKEY(0).
The latter is recommended since it does not disturb the current
screen cursor position.
Examples
. This example illustrates how to store the WAIT keystroke as an
array element:
aVar := ARRAY(6)
WAIT "Press a key..." TO aVar[1]
? aVar[1] // Result: key pressed in
// response to WAIT
? aVar[2] // Result: NIL
? VALTYPE(aVar) // Result: A
? VALTYPE(aVar[1]) // Result: C
Files Library is CLIPPER.LIB.
See Also:
@...GET
ACCEPT*
INKEY()
INPUT*
MENU TO
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson