READKEY()*
 Determine what key terminated a READ
------------------------------------------------------------------------------
 Syntax

     READKEY() --> nReadkeyCode

 Returns

     READKEY() returns a code representing the key pressed to exit a READ.
     In CA-Clipper, the following keys are the standard READ exit keys and
     their READKEY() return codes:

     READKEY() Return Codes
     ------------------------------------------------------------------------
     Exit Key             Return Code
     ------------------------------------------------------------------------
     Uparrow              5
     Dnarrow              2
     PgUp                 6
     PgDn                 7
     Ctrl-PgUp           31
     Ctrl-PgDn           30
     Esc                 12
     Ctrl-End, Ctrl-W    14
     Type past end       15
     Return              15
     ------------------------------------------------------------------------

 Description

     READKEY() is a keyboard function that emulates the READKEY() function in
     dBASE III PLUS.  Its purpose is to determine what key the user pressed
     to terminate a READ.  If UPDATED() is true (.T.), READKEY() returns the
     code plus 256.  Uparrow and Dnarrow exit a READ only if READEXIT()
     returns true (.T.).  The default value is false (.F.).  To provide
     complete compatibility for these keys, execute a READEXIT (.T.) at the
     beginning of your main procedure.

     READKEY() is supplied as a compatibility function and therefore its use
     is strongly discouraged.  It is superseded entirely by LASTKEY() which
     determines the last keystroke fetched from the keyboard buffer.  If the
     keystroke was a READ exit key, LASTKEY() will return the INKEY() code
     for that key.  To determine whether any Get object's buffer was modified
     during a READ, it is superseded by the UPDATED() function.

 Files:  Library is EXTEND.LIB, source file is SOURCE\SAMPLE\READKEY.PRG.