Home > CBM > BASIC > Keywords > Get
180 Subpages: (divide), (equal), (less), (minus), (more), (multiply), (plus), (power), Abs, And, Append, Asc, Atn, Auto, Backup, Bank, Begin, Bend, Bload, Boot, Box, Bsave, Bump, Catalog, Char, Chr, Circle, Close, Clr, Cmd, Collect, Collision, Color, Concat, Cont, Copy, Cos, Data, Dclear, Dclose, Dec, Def, Delete, Dim, Directory, Dispose, Dload, Do, Dopen, Draw, Ds, Ds string, Dsave, Dverify, El, Else, End, Envelope, Er, Err, Exit, Exp, Fast, Fetch, Filter, Fn, For, Fre, Get num, Getkey, Go, Gosub, Goto, Graphic, Gshape, Header, Help, Hex, If, Input, Input num, Instr, Int, Joy, Key, Left, Len, Let, List, Load, Locate, Log, Loop, Mid, Monitor, Movspr, New, Next, Not, Off, On, Open, Or, Paint, Peek, Pen, Pi, Play, Pointer, Poke, Pos, Pot, Print, Print num, Pudef, Quit, Rclr, Rdot, Read, Record, Rem, Rename, Renumber, Restore, Resume, Return, Rgr, Right, Rlum, Rnd, Rreg, Rspcolor, Rsppos, Rsprite, Run, Rwindow, Save, Scale, Scnclr, Scratch, Sgn, Sin, Sleep, Slow, Sound, Spc, Sprcolor, Sprdef, Sprite, Sprsav, Sqr, Sshape, St, Stash, Step, Stop, Str, Swap, Sys, Tab, Tan, Tempo, Then, Ti, Ti string, To, Trap, Troff, Tron, Until, Using, Usr, Val, Verify, Vol, Wait, While, Width, Window, Xor

KeywordAbbreviationToken (hex)Version(s)Classification
GETG{Shift+E}A11.0+Statement

 Syntax 
GET variable [ , variable ] ...
 
ParametersTypeLegal Value(s)Default ValueNote(s)
variableString or numericany except reserved variableType 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