INCHR
=====

Function
--------

**INCHR** inputs a single character from the keyboard.

Syntax
------

| INCHR variable name
| INCHR["PROMPT STRING";] variable name

Examples
--------

::

   10 INCHR "DECIMAL VALUE"; A
   20 PRINT A
   30 GOTO 10

displays:

::

   DECIMAL VALUE ?A 65
   DECIMAL VALUE ?B 66
   etc.

Remarks
-------

INCHR does not wait for ENTER to be pressed. A prompt message is
displayed as with :doc:`input`. Only one variable may be
entered. The variable is set to the decimal value of the character, as
detailed in section :doc:`../appendix/ascii-character-set`.

A comma following INCHR or the prompt message will suppress the prompt
character '?'. The comma replaces the semicolon in the syntax.

.. Note::

   No values are returned for SHIFT, HELP, CONTROL or POWER keys,
   although these function normally during INCHR.

ESC cannot be used to return to Basic from an INCHR loop, since it
simply returns the value 27!