# NEXTKEY()

Get the next key code in the buffer without extracting it.

Syntax

  NEXTKEY( [<nInputMask>] ) --> nKey

Arguments

  nInputMask is an optional integer value composed of one or more INKEY_ or HB_INKEY_ constants. The sole purpose of this argument is to allow switching between using HB_INKEY_EXTENDED key codes and using the normal Clipper-compatible key codes

Returns

  <nKey> The value of the next key in the Harbour keyboard buffer.

Description

  Returns the value of the next key in the Harbour keyboard buffer without extracting it.

Examples

          // Use NEXTKEY() with INKEY() to change display characters, or by
          // itself to exit the loop, so that the caller can detect the Esc.
          LOCAL nKey, cChar := "+"
          WHILE TRUE
             ?? cChar
             nKey := NEXTKEY()
             IF nKey == K_ESC
                EXIT
             ELSE
                IF nKey != 0
                   cChar := CHR( nKey )
                END IF
             END IF
          END WHILE
    Tests
          KEYBOARD "AB"; ? NEXTKEY(), NEXTKEY() ==>   65   65

Status

  Ready

Compliance

  NEXTKEY() is compliant with CA-Clipper 5.3, but has been extended for Harbour.

Files

  Library is rtl

See Also

- INKEY()
- LASTKEY()