Home > CBM > BASIC > Keywords > List
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, Get num, Getkey, Go, Gosub, Goto, Graphic, Gshape, Header, Help, Hex, If, Input, Input num, Instr, Int, Joy, Key, Left, Len, Let, 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 |
| Keyword | Abbreviation | Token (hex) | Version(s) | Classification | | LIST | L{Shift+I} | 9B | 1.0+ | Command and Statement* |
LIST [ { firstLine [ - [ lastLine ] ] | - lastLine } ] | Parameters | Type | Legal Value(s) | Default Value | Note(s) | | firstLine | Literal integer | 0 to 63999 | 0 | | | lastLine | Literal integer | 0 to 63999, but not less than firstLine | 63999 | |
Print the BASIC program line(s) in memory to the current output device.
LIST is obstensibly for viewing (portions of) a BASIC program, but due to the full-screen text editor of the CBM machines, it is often used while (re)writing and debugging a program. All program lines in memory (if any) are printed if no parameters are supplied. If parameters are supplied, they must be literal integer values; attempts to use a floating-point literal value, a variable, or a mathematical expression will generate SYNTAX ERROR. If both parameters are supplied, but lastLine is less than firstLine then nothing is printed and no error is generated (this doesn't seem very logical). If firstLine is greater than the last line number of the program, or if lastLine is less than the first line number of the program, then nothing is printed and no error is generated (this is quite logical). If only firstLine is supplied, and without the optional hyphen/minus (-), then only the program with that specific line number is printed, if it exists (no error otherwise). If only firstLine is supplied and is followed with a hyphen/mnus, then all lines of the program greater or equal to firstLine (if any) are printed. Similarly, if only a hyphen/minus and lastLine is given, then all lines less than or equal to lastLine (if any) are printed. Finally if both parameters are given, and firstLine is less than or equal to lastLine, then all program lines numbered from firstLine to lastLine (inclusive) are printed, if any exist in that range. That last paragraph doesn't read very well. It operates quite simply in practice; see the examples. * Some versions of BASIC (such as v2 of the C64) contain a bug, such that if LIST is used as a statement in a program, the program will stop without any error message. It works fine in v7.0; I'm not sure about other versions. This isn't a big deal since LIST is normally only used as a command in direct mode. Examples:
NEW
READY.
10 REM LINE 10
20 REM LINE 20
LIST
10 REM LINE 10
20 REM LINE 20
READY.
LIST 15
READY.
LIST 15-
20 REM LINE 20
READY.
LIST -15
10 REM LINE 10
READY.
|
© H2Obsession, 2014 |