Commodore‎ > ‎BASIC‎ > ‎Keywords‎ > ‎

GET

Keyword Abbreviation Token (hex) Version(s) Classification
GET G{Shift+E} A1 1.0+ Statement

  Syntax  
GET variable [ , variable ] ...
 
Parameters Type Legal Value(s) Default Value Note(s)
variable String or numeric any except reserved variable Type must be valid for the data that comes from the keyboard
 
  Purpose  
Data input; read a character from the keyboard (perhaps multiple times).

 
  Remarks  
This statement reads single character(s), if available, from the keyboard buffer. If no characters are available, each variable is assigned 0 (if variable is numeric type) or an empty string (if variable is string type).

Each item read from the keyboard (assuming a character is available) must be compatible with each variable's type.  So a string variable must be specified if text is to be read.  A numeric variable is sometimes used to read numeric values, but often a string variable will be used in these cases too.  This is because if non-numeric characters are read when trying to input into a numeric variable, a TYPE MISMATCH ERROR is generated.  A string variable will accept any character.

To GET a single character, GETKEY is typically used in BASIC v3.5 or 7.0.
 
Failure to specify at least one variable results in SYNTAX ERROR.
 
GET may only be used as a statement in a program.  Outside of a program (i.e., in direct mode) it will generate ILLEGAL DIRECT ERROR. 
 
Example (it runs so fast it will print 0 unless you have EXTREMELY FAST keyboard skills):
NEW

READY.
10 GET K
20 PRINT K
RUN
 0

READY.
 
Example (typical for 1.0, 2.x, and 4.x):
NEW

READY.
10 GET K$ : IF K$ = "" THEN 10
20 PRINT K$
RUN
 H          user typed an H 

READY.
 
 
  Compare With  
 
  Contrast With  

© H2Obsession, 2014
Comments