Available on:
See also: SCANCODE

INKEY

The ''INKEY' (or INKEY$) capture a single character typed by the user without having to press enter. In other words, the program is "listening" to the keyboard and, as soon as a key is pressed, "captures" it and stores it in a variable.

Unlike the INPUT command, which requires the user to press enter after typing, INKEY reads the character as soon as it is pressed. If no key has been pressed, INKEY$ returns an empty string (""). The captured character is stored in a string variable.

It is used to create interactive games where the user can control the character or objects by pressing specific keys, to create text menus where the user can select an option by pressing a letter or number or to create programs that respond to external events, such as pressing a key to start or stop an action.

The INKEY$ only reads one character at a time. To read a complete string, you must use other commands or techniques. The command does not usually display the pressed character on the screen.

SYNTAX

 = INKEY$


Legend
  • id : identifier
  • type : datatype
  • v : value
  • "..." : string
  • [...] : optional

EXAMPLE

 IF INKEY$ = "A" THEN
    PRINT "A has been pressed!"
 ENDIF


ABBREVIATION: Iky

Join BASIC 10Liner Contest with ugBASIC!

An interesting competition is held at the beginning of each year: the BASIC 10Liner Contest. It is possible to use ugBASIC to participate in the next "BASIC10Liner" competition, in the following categories:

  • PUR-120 - A game in 10 lines of max 120 characters (w/abbrev.)
  • EXTREME-256 - A game in 10 lines of max 256 characters (w/abbrev.)
  • SCHAU - Any program in 10 lines of max 256 characters (w/abbrev.)
In order to reduce space you can use this abbreviation for this instruction:

INKEY ↔ Iky

Any problem?

If you have found a problem with this keyword, if you think there is a bug or, more simply, you would like it to be improved, open an issue for this example on GitHub.
Thank you!

open an issue BACK TO KEYWORDS