Click above to get retro games delivered to your door ever month!

 C_KEYBOARD()

 DESCRIPTION

 C_KEYBOARD() manipulates the keyboard buffer allowing keystrokes to
 be placed in the buffer as if they had been entered on the
 keyboard.  C_KEYBOARD() provides the ability of appending to the
 buffer rather than clearing the buffer.  Additionally, C_KEYBOARD()
 called with no parameters clears the keyboard buffer.

 NOTES

 C_KEYBOARD() is similar to Clipper's KEYBOARD and CLEAR TYPEAHEAD
 commands, except with more flexibility.  C_KEYBOARD() can be used
 to place a single character or multiple characters in the keyboard
 buffer, but unlike KEYBOARD does not overwrite what is currently in
 the buffer.  This allows multiple calls to be made to C_KEYBOARD()
 to add additional characters into the buffer.

 SYNTAX

 C_KEYBOARD([string/inkey_code])

 PARAMETERS

 string/inkey_code (C/N) is the character string or INKEY() code to
 place in the keyboard buffer.  The parameter can be any character
 string, number, or INKEY() code to be placed in the keyboard
 buffer.  If the parameter is not supplied, the keyboard buffer is cleared.

 RETURNS

 C_KEYBOARD() returns the contents of the keyboard buffer as a
 character string before placing any new characters in it.

 EXAMPLES

 c_keyboard(chr(13))       && stuff an ENTER key
 c_keyboard(13)            && ENTER key using INKEY code (same as previous)
 c_keyboard("hello")       && stuff a string
 c_keyboard(123.45)        && stuff a number
 c_keyboard(zip+chr(13))   && stuff a database field + ENTER
 c_keyboard()              && clear keyboard buffer