Files
VCCPlusOSS/platforms/macos/Resources/BASICReference.json
T

5238 lines
132 KiB
JSON

{
"entries": [
{
"id": "ERROR./0",
"keyword": "/0",
"title": "/0 — Division by zero",
"category": "Errors",
"dialect": "common",
"summary": "A denominator evaluated to zero. Check the values at the reported line.",
"syntax": [
"/0 ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"IF"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "ABS",
"keyword": "ABS",
"title": "ABS",
"category": "Math",
"dialect": "common",
"summary": "Return the magnitude of a number.",
"syntax": [
"ABS(number)"
],
"parameters": [],
"sample": "PRINT ABS(-7)",
"exampleID": "math",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "ERROR.AE",
"keyword": "AE",
"title": "AE — File already exists",
"category": "Errors",
"dialect": "disk",
"summary": "The destination name is already in use. Choose another name or use the documented replacement behavior.",
"syntax": [
"AE ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"COPY",
"RGB.COPY",
"RENAME"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "AND",
"keyword": "AND",
"title": "AND",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Combine integer bit patterns; often used to join conditions.",
"syntax": [
"expression AND expression"
],
"parameters": [],
"sample": "IF A>0 AND B>0 THEN PRINT \"BOTH\"",
"exampleID": null,
"related": [
"OR",
"NOT",
"IF"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ERROR.AO",
"keyword": "AO",
"title": "AO — Already open",
"category": "Errors",
"dialect": "common",
"summary": "The file is already open. Close it before reopening; on SDC, an image cannot be mounted twice.",
"syntax": [
"AO ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"CLOSE",
"OPEN",
"SDC.DRIVE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "AS",
"keyword": "AS",
"title": "AS",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Give a string variable a field within a direct-access file buffer.",
"syntax": [
"FIELD #file,length AS stringVariable"
],
"parameters": [],
"sample": "FIELD #1,20 AS N$",
"exampleID": null,
"related": [
"FIELD"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ASC",
"keyword": "ASC",
"title": "ASC",
"category": "Strings",
"dialect": "common",
"summary": "Return the character code of the first character.",
"syntax": [
"ASC(string)"
],
"parameters": [
"The string must not be empty."
],
"sample": "PRINT ASC(\"A\")",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "ATN",
"keyword": "ATN",
"title": "ATN",
"category": "Math",
"dialect": "common",
"summary": "Return the arctangent in radians.",
"syntax": [
"ATN(number)"
],
"parameters": [
"Multiply by 180/PI to convert the result to degrees."
],
"sample": "PRINT ATN(1)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "ATTR",
"keyword": "ATTR",
"title": "ATTR",
"category": "Text and output",
"dialect": "common",
"summary": "Choose text colors and optional character attributes.",
"syntax": [
"ATTR foreground,background[,B][,U]"
],
"parameters": [
"B enables blinking; U enables underlining."
],
"sample": "WIDTH 80:ATTR 3,0,U",
"exampleID": null,
"related": [
"WIDTH",
"LOCATE",
"PALETTE"
],
"notes": [
"CoCo 3 high-resolution text modes."
],
"source": "basicGuide",
"sourcePage": "2"
},
{
"id": "AUDIO",
"keyword": "AUDIO",
"title": "AUDIO",
"category": "Cassette",
"dialect": "common",
"summary": "Connect or disconnect cassette playback sound from the CoCo audio output.",
"syntax": [
"AUDIO ON",
"AUDIO OFF"
],
"parameters": [],
"sample": "AUDIO ON",
"exampleID": null,
"related": [
"MOTOR",
"CLOAD",
"SOUND"
],
"notes": [
"Use the cassette transport and audio settings in VCC Plus to supply and hear tape playback."
],
"source": "basicGuide",
"sourcePage": "2"
},
{
"id": "BACKUP",
"keyword": "BACKUP",
"title": "BACKUP",
"category": "Disk files",
"dialect": "disk",
"summary": "Duplicate a BASIC disk onto another disk.",
"syntax": [
"BACKUP source TO destination",
"BACKUP drive"
],
"parameters": [
"Single-drive form requires disk exchanges."
],
"sample": "BACKUP 0 TO 1",
"exampleID": null,
"related": [
"COPY"
],
"notes": [
"Overwrites the destination disk. Use a new disposable image, never the only copy of your data."
],
"source": "diskGuide",
"sourcePage": "3"
},
{
"id": "ERROR.BR",
"keyword": "BR",
"title": "BR — Bad record",
"category": "Errors",
"dialect": "disk",
"summary": "The direct-access record number is invalid.",
"syntax": [
"BR ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"DISK.GET",
"DISK.PUT",
"LOC",
"LOF"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "BRK",
"keyword": "BRK",
"title": "BRK",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Introduce a Break-key trap as part of ON BRK GOTO.",
"syntax": [
"ON BRK GOTO line"
],
"parameters": [],
"sample": "ON BRK GOTO 100",
"exampleID": null,
"related": [
"ON.BRK"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ERROR.BS",
"keyword": "BS",
"title": "BS — Bad subscript",
"category": "Errors",
"dialect": "common",
"summary": "An array index is outside its declared bounds or has the wrong number of dimensions.",
"syntax": [
"BS ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"DIM"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "BUTTON",
"keyword": "BUTTON",
"title": "BUTTON",
"category": "Input",
"dialect": "common",
"summary": "Read a joystick button on the CoCo 3.",
"syntax": [
"BUTTON(number)"
],
"parameters": [
"0/1: right first/second button; 2/3: left first/second button.",
"Returns 1 when pressed, otherwise 0."
],
"sample": "PRINT BUTTON(2)",
"exampleID": null,
"related": [
"JOYSTK"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "CHR$",
"keyword": "CHR$",
"title": "CHR$",
"category": "Strings",
"dialect": "common",
"summary": "Return the character with the specified code.",
"syntax": [
"CHR$(code)"
],
"parameters": [
"code: 0-255.",
"Control codes may move the cursor or change display behavior."
],
"sample": "PRINT CHR$(65)",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "CIRCLE",
"keyword": "CIRCLE",
"title": "CIRCLE",
"category": "Graphics",
"dialect": "common",
"summary": "Draw a circle, ellipse or arc on the PMODE screen.",
"syntax": [
"CIRCLE(x,y),radius[,color[,ratio[,start,end]]]"
],
"parameters": [
"ratio changes height relative to width.",
"start and end select fractions of a full turn."
],
"sample": "CIRCLE(128,96),30",
"exampleID": null,
"related": [
"LINE",
"PAINT",
"HCIRCLE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "2"
},
{
"id": "CLEAR",
"keyword": "CLEAR",
"title": "CLEAR",
"category": "Variables and arrays",
"dialect": "common",
"summary": "Clear variables and adjust string space or the BASIC memory ceiling.",
"syntax": [
"CLEAR [stringBytes [, topAddress]]"
],
"parameters": [
"stringBytes reserves string workspace.",
"topAddress leaves higher memory for machine-language code."
],
"sample": "CLEAR 300",
"exampleID": null,
"related": [
"MEM",
"ERROR.OS"
],
"notes": [
"This discards current variable values; do not use it merely to clear the display."
],
"source": "basicGuide",
"sourcePage": "2"
},
{
"id": "CLOAD",
"keyword": "CLOAD",
"title": "CLOAD",
"category": "Cassette",
"dialect": "common",
"summary": "Load a BASIC program from cassette.",
"syntax": [
"CLOAD [\"filename\"]"
],
"parameters": [
"Omitting the name selects the next BASIC program.",
"Cassette names have up to eight characters."
],
"sample": "CLOAD \"HELLO\"",
"exampleID": null,
"related": [
"CLOADM",
"CSAVE"
],
"notes": [
"Loading replaces the program in CoCo memory. It does not open a Mac source document."
],
"source": "basicGuide",
"sourcePage": "2"
},
{
"id": "CLOADM",
"keyword": "CLOADM",
"title": "CLOADM",
"category": "Cassette",
"dialect": "common",
"summary": "Load a machine-language program from cassette.",
"syntax": [
"CLOADM [\"filename\"[,offset]]"
],
"parameters": [
"offset relocates loaded bytes; it does not rewrite addresses inside the program."
],
"sample": "CLOADM \"DEMO\"",
"exampleID": null,
"related": [
"EXEC",
"CSAVEM",
"CLOAD"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "3"
},
{
"id": "CLOSE",
"keyword": "CLOSE",
"title": "CLOSE",
"category": "Disk files",
"dialect": "disk",
"summary": "Finish access to one or more open files.",
"syntax": [
"CLOSE [#file[,#file ...]]"
],
"parameters": [
"With no file number, close all open files."
],
"sample": "CLOSE #1",
"exampleID": null,
"related": [
"OPEN",
"UNLOAD"
],
"notes": [
"Closing output files completes buffered writes."
],
"source": "diskGuide",
"sourcePage": "3"
},
{
"id": "CLS",
"keyword": "CLS",
"title": "CLS",
"category": "Text and output",
"dialect": "common",
"summary": "Clear the text screen.",
"syntax": [
"CLS [color]"
],
"parameters": [
"color chooses a text-screen background when supplied."
],
"sample": "CLS",
"exampleID": "hello",
"related": [
"PRINT",
"WIDTH",
"HCLS",
"PCLS"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "3"
},
{
"id": "CMP",
"keyword": "CMP",
"title": "CMP",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Restore the standard composite palette on a CoCo 3.",
"syntax": [
"PALETTE CMP"
],
"parameters": [],
"sample": "PALETTE CMP",
"exampleID": null,
"related": [
"PALETTE",
"RGB"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ERROR.CN",
"keyword": "CN",
"title": "CN — Cannot continue",
"category": "Errors",
"dialect": "common",
"summary": "BASIC no longer has a valid continuation after a stop. Restart with RUN if appropriate.",
"syntax": [
"CN ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"CONT",
"RUN",
"STOP"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "COLOR",
"keyword": "COLOR",
"title": "COLOR",
"category": "Graphics",
"dialect": "common",
"summary": "Choose foreground and background colors for PMODE graphics.",
"syntax": [
"COLOR foreground,background"
],
"parameters": [
"Available colors depend on the current graphics mode."
],
"sample": "COLOR 1,0",
"exampleID": null,
"related": [
"PMODE",
"PCLS",
"PSET"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "3"
},
{
"id": "CONT",
"keyword": "CONT",
"title": "CONT",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Continue after an ordinary BASIC stop when the interpreter still has a valid continuation.",
"syntax": [
"CONT"
],
"parameters": [],
"sample": "CONT",
"exampleID": null,
"related": [
"STOP",
"ERROR.CN"
],
"notes": [
"The editor Continue button resumes its debugger stop. It does not type this command.",
"Changing the program can invalidate BASIC's saved continuation."
],
"source": "basicGuide",
"sourcePage": "3"
},
{
"id": "COPY",
"keyword": "COPY",
"title": "COPY",
"category": "Disk files",
"dialect": "disk",
"summary": "Copy one BASIC disk file to another filename or drive.",
"syntax": [
"COPY \"source/ext:drive\" TO \"destination/ext:drive\""
],
"parameters": [
"Include the filename extensions."
],
"sample": "COPY \"HELLO/BAS:0\" TO \"HELLO/BAS:1\"",
"exampleID": null,
"related": [
"RGB.COPY",
"BACKUP"
],
"notes": [
"Writes to the destination disk. RGB-DOS changes overwrite behavior; see its variant entry."
],
"source": "diskGuide",
"sourcePage": "3"
},
{
"id": "RGB.COPY",
"keyword": "COPY",
"title": "COPY — RGB-DOS",
"category": "DOS differences",
"dialect": "rgbdos",
"summary": "Copy a file, retaining its name when the destination is only a drive number.",
"syntax": [
"COPY \"source/ext:drive\" TO drive",
"COPY \"source/ext:drive\" TO \"destination/ext:drive\""
],
"parameters": [],
"sample": "COPY \"HELLO/BAS:0\" TO 1",
"exampleID": null,
"related": [
"COPY",
"RGB.DRIVE"
],
"notes": [
"Writes the destination. Direct mode asks before replacing an existing file; inside a BASIC program, replacement occurs without that prompt."
],
"source": "rgbdos",
"sourcePage": "PDF page 8"
},
{
"id": "COS",
"keyword": "COS",
"title": "COS",
"category": "Math",
"dialect": "common",
"summary": "Return the cosine of an angle in radians.",
"syntax": [
"COS(angle)"
],
"parameters": [
"Angles are radians, not degrees."
],
"sample": "PRINT COS(0)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "CSAVE",
"keyword": "CSAVE",
"title": "CSAVE",
"category": "Cassette",
"dialect": "common",
"summary": "Record the current BASIC program on cassette.",
"syntax": [
"CSAVE \"filename\"[,A]"
],
"parameters": [
"A selects ASCII rather than tokenized program storage."
],
"sample": "CSAVE \"HELLO\"",
"exampleID": null,
"related": [
"CLOAD",
"CSAVEM"
],
"notes": [
"Prepare the cassette recording transport first. Export the recording in VCC Plus to retain it as a Mac file."
],
"source": "basicGuide",
"sourcePage": "3"
},
{
"id": "CSAVEM",
"keyword": "CSAVEM",
"title": "CSAVEM",
"category": "Cassette",
"dialect": "common",
"summary": "Record a memory range as a machine-language cassette file.",
"syntax": [
"CSAVEM \"filename\",first,last,entry"
],
"parameters": [
"first and last are inclusive byte addresses; entry is the EXEC address."
],
"sample": "CSAVEM \"DEMO\",&H5000,&H50FF,&H5000",
"exampleID": null,
"related": [
"CLOADM",
"EXEC"
],
"notes": [
"Prepare cassette recording before issuing the command."
],
"source": "basicGuide",
"sourcePage": "4"
},
{
"id": "CVN",
"keyword": "CVN",
"title": "CVN",
"category": "Disk files",
"dialect": "disk",
"summary": "Decode a five-byte BASIC number stored in a string.",
"syntax": [
"CVN(string)"
],
"parameters": [
"The string must contain the expected numeric encoding."
],
"sample": "A=CVN(MKN$(42))",
"exampleID": null,
"related": [
"MKN$"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "3"
},
{
"id": "DATA",
"keyword": "DATA",
"title": "DATA",
"category": "Variables and arrays",
"dialect": "common",
"summary": "Place constant values in a program for READ.",
"syntax": [
"DATA constant [, constant ...]"
],
"parameters": [
"Use quotes around strings containing commas."
],
"sample": "DATA 12,\"COCO\"",
"exampleID": "data",
"related": [
"READ",
"RESTORE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "4"
},
{
"id": "ERROR.DD",
"keyword": "DD",
"title": "DD — Duplicate dimension",
"category": "Errors",
"dialect": "common",
"summary": "An array has already been dimensioned or implicitly created. Dimension it before its first use.",
"syntax": [
"DD ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"DIM"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "DEF",
"keyword": "DEF",
"title": "DEF",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Introduce a user-defined BASIC or machine-language function.",
"syntax": [
"DEF FNname(argument)=expression",
"DEF USRn=address"
],
"parameters": [],
"sample": "DEF FNA(X)=X*X",
"exampleID": null,
"related": [
"DEF.FN",
"DEF.USR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "DEF.FN",
"keyword": "DEF FN",
"title": "DEF FN",
"category": "Math",
"dialect": "common",
"summary": "Define a numeric function to evaluate later.",
"syntax": [
"DEF FNname(parameter) = expression"
],
"parameters": [
"FNname is invoked with a numeric argument."
],
"sample": "DEF FNA(X)=X*X",
"exampleID": "math",
"related": [
"FN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "4"
},
{
"id": "DEF.USR",
"keyword": "DEF USR",
"title": "DEF USR",
"category": "Machine language",
"dialect": "common",
"summary": "Set the entry address of a machine-language function.",
"syntax": [
"DEF USRn = address"
],
"parameters": [
"n: 0-9; the function must follow BASIC's machine-language calling convention."
],
"sample": "DEF USR0=&H5000",
"exampleID": null,
"related": [
"USR",
"EXEC"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "4"
},
{
"id": "DEL",
"keyword": "DEL",
"title": "DEL",
"category": "Source editing",
"dialect": "common",
"summary": "Delete one or more lines from the CoCo's in-memory program.",
"syntax": [
"DEL first[-last]",
"DEL -last",
"DEL first-"
],
"parameters": [],
"sample": "DEL 100-200",
"exampleID": null,
"related": [
"LIST",
"NEW"
],
"notes": [
"Use care: the interpreter does not provide Mac-style Undo for this command."
],
"source": "basicGuide",
"sourcePage": "4"
},
{
"id": "ERROR.DF",
"keyword": "DF",
"title": "DF — Disk full",
"category": "Errors",
"dialect": "disk",
"summary": "There is insufficient space for the write. Use another working image or remove unneeded files carefully.",
"syntax": [
"DF ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"FREE",
"DIR"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "DIM",
"keyword": "DIM",
"title": "DIM",
"category": "Variables and arrays",
"dialect": "common",
"summary": "Reserve numeric or string arrays with inclusive upper bounds.",
"syntax": [
"DIM name(upperBound [, upperBound ...]) [, ...]"
],
"parameters": [
"Indices start at zero: DIM A(5) provides six elements.",
"Dimension an array before using it; do not dimension it twice."
],
"sample": "DIM A(5),N$(2,3)",
"exampleID": "arrays",
"related": [
"ERROR.BS",
"ERROR.DD"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "5"
},
{
"id": "DIR",
"keyword": "DIR",
"title": "DIR",
"category": "Disk files",
"dialect": "disk",
"summary": "List files stored on a BASIC disk.",
"syntax": [
"DIR [drive]"
],
"parameters": [
"Omit drive to list the default drive.",
"The listing shows name, extension, type, storage form and granule count."
],
"sample": "DIR 0",
"exampleID": "disk-directory",
"related": [
"DRIVE",
"RGB.DRIVE",
"SDC.DIR"
],
"notes": [
"In SDC-DOS, plain DIR still lists the mounted disk; DIR - browses the SD folder."
],
"source": "diskGuide",
"sourcePage": "3"
},
{
"id": "SDC.DIR",
"keyword": "DIR",
"title": "DIR — SDC-DOS",
"category": "DOS differences",
"dialect": "sdcdos",
"summary": "Browse the card folder instead of the files inside a mounted disk.",
"syntax": [
"DIR -",
"DIR \"path\"",
"DIR = \"path\""
],
"parameters": [
"DIR = \"/\" selects the card root; DIR = \"..\" selects its parent folder."
],
"sample": "DIR = \"/\":DIR -",
"exampleID": "sdc-mount",
"related": [
"DIR",
"SDC.DRIVE"
],
"notes": [
"Paths are relative to the SDC card folder selected in VCC Plus, not arbitrary Mac paths.",
"Plain DIR 0 still lists files inside the image mounted in drive 0."
],
"source": "sdcGuide",
"sourcePage": "11-12"
},
{
"id": "DLOAD",
"keyword": "DLOAD",
"title": "DLOAD",
"category": "Machine language",
"dialect": "common",
"summary": "Historical serial program-loading command.",
"syntax": [
"DLOAD [\"filename\"]"
],
"parameters": [
"Requires a compatible serial host and protocol."
],
"sample": "DLOAD \"PROGRAM\"",
"exampleID": null,
"related": [
"CLOAD",
"LOAD"
],
"notes": [
"The bundled CoCo 3 environment does not provide the historical DLOAD host service. Use native source opening or media loading instead."
],
"source": "basicGuide",
"sourcePage": null
},
{
"id": "ERROR.DN",
"keyword": "DN",
"title": "DN — Device number",
"category": "Errors",
"dialect": "common",
"summary": "The selected device or drive number is not valid for this operation.",
"syntax": [
"DN ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"OPEN",
"DRIVE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "DOS",
"keyword": "DOS",
"title": "DOS",
"category": "Disk files",
"dialect": "disk",
"summary": "Invoke a boot loader from drive 0.",
"syntax": [
"DOS"
],
"parameters": [
"Drive 0 must contain a compatible boot loader."
],
"sample": "DOS",
"exampleID": null,
"related": [
"RGB.DOS"
],
"notes": [
"A boot loader can start another operating system or a program; DOS does not always mean OS-9."
],
"source": "diskGuide",
"sourcePage": "3"
},
{
"id": "RGB.DOS",
"keyword": "DOS",
"title": "DOS — RGB-DOS",
"category": "DOS differences",
"dialect": "rgbdos",
"summary": "Boot a selected BASIC volume, or try its AUTOEXEC program.",
"syntax": [
"DOS [drive]"
],
"parameters": [],
"sample": "DOS 255",
"exampleID": null,
"related": [
"DOS",
"RGB.DRIVE"
],
"notes": [
"The NitrOS-9 preset boots automatically. Its running OS-9 shell is not a BASIC editor target."
],
"source": "rgbdos",
"sourcePage": "PDF page 7"
},
{
"id": "DRAW",
"keyword": "DRAW",
"title": "DRAW",
"category": "Graphics",
"dialect": "common",
"summary": "Draw PMODE graphics using a compact movement string.",
"syntax": [
"DRAW string"
],
"parameters": [
"U,D,L,R move in the four main directions; E,F,G,H move diagonally.",
"BM moves without drawing. C selects color, S scale and A angle.",
"X executes a string variable embedded in the drawing sequence."
],
"sample": "DRAW \"BM40,40;R30;D30;L30;U30\"",
"exampleID": null,
"related": [
"HDRAW",
"LINE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "5"
},
{
"id": "DRIVE",
"keyword": "DRIVE",
"title": "DRIVE",
"category": "Disk files",
"dialect": "disk",
"summary": "Choose the default drive for later disk commands.",
"syntax": [
"DRIVE number"
],
"parameters": [
"Disk BASIC uses drive numbers 0-3."
],
"sample": "DRIVE 0",
"exampleID": null,
"related": [
"DIR",
"RGB.DRIVE",
"SDC.DRIVE"
],
"notes": [
"RGB-DOS and SDC-DOS extend this command in different ways."
],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "RGB.DRIVE",
"keyword": "DRIVE",
"title": "DRIVE — RGB-DOS",
"category": "DOS differences",
"dialect": "rgbdos",
"summary": "Switch between virtual hard-disk volumes and floppy drives.",
"syntax": [
"DRIVE volume",
"DRIVE ON",
"DRIVE OFF [lastFloppy]",
"DRIVE #unit"
],
"parameters": [
"volume: 0-255 selects a default virtual BASIC disk. With DRIVE OFF, drives 0-3 refer to floppy drives instead.",
"DRIVE OFF exposes floppy drives; DRIVE ON restores hard-disk routing.",
"#unit selects the hard-disk unit. VCC Plus has HD0 and HD1."
],
"sample": "DRIVE OFF:DIR 0:DRIVE ON",
"exampleID": "rgb-routing",
"related": [
"DRIVE",
"DIR",
"RGB.DOS"
],
"notes": [
"The Hard Drive BASIC preset uses RGB-DOS. Do not confuse a virtual BASIC volume number with an HD device number.",
"Historical DRIVE STOP and DRIVE RESTORE hardware operations are not needed for VCC Plus image files."
],
"source": "rgbdos",
"sourcePage": "PDF page 7"
},
{
"id": "SDC.DRIVE",
"keyword": "DRIVE",
"title": "DRIVE — SDC-DOS",
"category": "DOS differences",
"dialect": "sdcdos",
"summary": "Inspect, mount or unload images on the SDC card.",
"syntax": [
"DRIVE",
"DRIVE drive,\"path\"[,volume]",
"DRIVE drive,UNLOAD"
],
"parameters": [
"drive is 0 or 1; volume selects a BASIC volume inside a compatible hard-disk image."
],
"sample": "DRIVE 0,\"HELLO.DSK\"",
"exampleID": "sdc-mount",
"related": [
"DRIVE",
"SDC.DIR",
"SDC.NEW"
],
"notes": [
"Use short card filenames. A mounted image is a disk containing BASIC files, not itself a BASIC program.",
"The same image cannot be mounted in both drives."
],
"source": "sdcGuide",
"sourcePage": "9-12"
},
{
"id": "SDC.NEW",
"keyword": "DRIVE NEW",
"title": "DRIVE NEW",
"category": "DOS differences",
"dialect": "sdcdos",
"summary": "Create and mount a new disk image in the selected card folder.",
"syntax": [
"DRIVE drive,\"filename.DSK\",NEW"
],
"parameters": [],
"sample": "DRIVE 0,\"WORK.DSK\",NEW",
"exampleID": null,
"related": [
"SDC.DRIVE",
"SDC.DIR",
"DSKINI"
],
"notes": [
"Writes a new file; it does not replace an existing one.",
"Hardware documentation also covers SDF, flash, RTC and DriveWire features. These are not supported SDC features in VCC Plus."
],
"source": "sdcGuide",
"sourcePage": "12"
},
{
"id": "ERROR.DS",
"keyword": "DS",
"title": "DS — Direct statement in file",
"category": "Errors",
"dialect": "common",
"summary": "A program being loaded contains a statement without a BASIC line number.",
"syntax": [
"DS ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"LOAD",
"MERGE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "DSKI$",
"keyword": "DSKI$",
"title": "DSKI$",
"category": "Disk files",
"dialect": "disk",
"summary": "Read a disk sector into two string variables.",
"syntax": [
"DSKI$ drive,track,sector,string1,string2"
],
"parameters": [
"The strings receive the two halves of a 256-byte sector."
],
"sample": "DSKI$ 0,17,1,A$,B$",
"exampleID": null,
"related": [
"DSKO$"
],
"notes": [
"Raw-sector access bypasses normal file interpretation."
],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "DSKINI",
"keyword": "DSKINI",
"title": "DSKINI",
"category": "Disk files",
"dialect": "disk",
"summary": "Initialize a disk for BASIC file storage.",
"syntax": [
"DSKINI [drive]"
],
"parameters": [
"Select the intended drive explicitly."
],
"sample": "DSKINI 1",
"exampleID": null,
"related": [
"FREE",
"DIR"
],
"notes": [
"Erases the selected disk and disturbs BASIC workspace. Use only a blank disposable image."
],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "DSKO$",
"keyword": "DSKO$",
"title": "DSKO$",
"category": "Disk files",
"dialect": "disk",
"summary": "Write two strings directly to a disk sector.",
"syntax": [
"DSKO$ drive,track,sector,string1,string2"
],
"parameters": [
"Use properly sized data for the selected sector."
],
"sample": "DSKO$ 1,17,1,A$,B$",
"exampleID": null,
"related": [
"DSKI$"
],
"notes": [
"Raw writes can corrupt the filesystem. This is not a safe way to save a BASIC program."
],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "EDIT",
"keyword": "EDIT",
"title": "EDIT",
"category": "Source editing",
"dialect": "common",
"summary": "Use the original BASIC line editor for one program line.",
"syntax": [
"EDIT line"
],
"parameters": [
"The native BASIC editor is a separate way to edit source."
],
"sample": "EDIT 100",
"exampleID": null,
"related": [
"LIST",
"DEL",
"RENUM"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "5"
},
{
"id": "ELSE",
"keyword": "ELSE",
"title": "ELSE",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Introduce the false branch of an IF statement.",
"syntax": [
"IF condition THEN statements ELSE statements"
],
"parameters": [],
"sample": "IF A=1 THEN PRINT \"ONE\" ELSE PRINT \"OTHER\"",
"exampleID": null,
"related": [
"IF",
"THEN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "END",
"keyword": "END",
"title": "END",
"category": "Program flow",
"dialect": "common",
"summary": "Finish the program.",
"syntax": [
"END"
],
"parameters": [],
"sample": "END",
"exampleID": "hello",
"related": [
"STOP",
"RUN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "5"
},
{
"id": "EOF",
"keyword": "EOF",
"title": "EOF",
"category": "Disk files",
"dialect": "disk",
"summary": "Check whether an open input stream is at end of file.",
"syntax": [
"EOF(file)"
],
"parameters": [
"0 means more input remains; -1 indicates end of file.",
"Also applies to cassette input with device -1."
],
"sample": "IF EOF(1) THEN CLOSE #1",
"exampleID": null,
"related": [
"OPEN",
"DISK.INPUT"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "ERROR.ER",
"keyword": "ER",
"title": "ER — End of record",
"category": "Errors",
"dialect": "disk",
"summary": "A direct-access operation went beyond the current record boundary. Check record size and fields.",
"syntax": [
"ER ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"OPEN",
"FIELD"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "ERLIN",
"keyword": "ERLIN",
"title": "ERLIN",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Read the BASIC line number that caused the trapped error.",
"syntax": [
"ERLIN"
],
"parameters": [
"Use inside an ON ERR handler."
],
"sample": "PRINT ERLIN",
"exampleID": "error-trap",
"related": [
"ERNO",
"ON.ERR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "ERNO",
"keyword": "ERNO",
"title": "ERNO",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Read the numeric code for the last trapped BASIC error.",
"syntax": [
"ERNO"
],
"parameters": [
"Use inside an ON ERR handler."
],
"sample": "PRINT ERNO",
"exampleID": "error-trap",
"related": [
"ERLIN",
"ON.ERR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "18"
},
{
"id": "ERR",
"keyword": "ERR",
"title": "ERR",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Introduce an error trap as part of ON ERR GOTO.",
"syntax": [
"ON ERR GOTO line"
],
"parameters": [],
"sample": "ON ERR GOTO 100",
"exampleID": null,
"related": [
"ON.ERR",
"ERNO",
"ERLIN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "EXEC",
"keyword": "EXEC",
"title": "EXEC",
"category": "Machine language",
"dialect": "common",
"summary": "Transfer execution to a machine-language entry point.",
"syntax": [
"EXEC [address]"
],
"parameters": [
"Without an address, use the entry point from the last applicable machine-language load."
],
"sample": "EXEC &H5000",
"exampleID": null,
"related": [
"LOADM",
"CLOADM",
"DEF.USR"
],
"notes": [
"Running arbitrary memory as code can crash or alter the emulated machine."
],
"source": "basicGuide",
"sourcePage": "6"
},
{
"id": "EXP",
"keyword": "EXP",
"title": "EXP",
"category": "Math",
"dialect": "common",
"summary": "Raise e to a numeric power.",
"syntax": [
"EXP(number)"
],
"parameters": [
"Large arguments can overflow."
],
"sample": "PRINT EXP(0)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "ERROR.FC",
"keyword": "FC",
"title": "FC — Illegal function call",
"category": "Errors",
"dialect": "common",
"summary": "An argument is outside the range accepted by this command or function. Check its parameter descriptions.",
"syntax": [
"FC ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"SQR",
"ASC"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "ERROR.FD",
"keyword": "FD",
"title": "FD — Bad file data",
"category": "Errors",
"dialect": "common",
"summary": "The next input value cannot be read into the requested variable type.",
"syntax": [
"FD ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"INPUT",
"DISK.INPUT",
"WRITE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "FIELD",
"keyword": "FIELD",
"title": "FIELD",
"category": "Disk files",
"dialect": "disk",
"summary": "Divide a direct-access buffer into string fields.",
"syntax": [
"FIELD #file,length AS stringVariable[, ...]"
],
"parameters": [
"Field lengths must fit in the opened record."
],
"sample": "FIELD #1,20 AS N$,5 AS V$",
"exampleID": null,
"related": [
"OPEN",
"LSET",
"RSET",
"DISK.GET",
"DISK.PUT"
],
"notes": [
"Use LSET/RSET rather than ordinary string assignment when filling fields."
],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "FILES",
"keyword": "FILES",
"title": "FILES",
"category": "Disk files",
"dialect": "disk",
"summary": "Allocate file buffers for disk access.",
"syntax": [
"FILES count[,size]"
],
"parameters": [
"count reserves file buffers; size supplies the total buffer size."
],
"sample": "FILES 2",
"exampleID": null,
"related": [
"OPEN",
"FIELD"
],
"notes": [
"Changes BASIC workspace allocation. Arrange file buffers before storing working data."
],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "FIX",
"keyword": "FIX",
"title": "FIX",
"category": "Math",
"dialect": "common",
"summary": "Remove the fractional part toward zero.",
"syntax": [
"FIX(number)"
],
"parameters": [
"FIX(-2.7) is -2."
],
"sample": "PRINT FIX(-2.7)",
"exampleID": "math",
"related": [
"INT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "ERROR.FM",
"keyword": "FM",
"title": "FM — File mode",
"category": "Errors",
"dialect": "common",
"summary": "The operation does not match the mode used to open the file.",
"syntax": [
"FM ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"OPEN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "FN",
"keyword": "FN",
"title": "FN",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Invoke a function defined with DEF FN.",
"syntax": [
"FNname(argument)"
],
"parameters": [],
"sample": "PRINT FNA(3)",
"exampleID": null,
"related": [
"DEF.FN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ERROR.FN",
"keyword": "FN",
"title": "FN — Bad filename",
"category": "Errors",
"dialect": "disk",
"summary": "The filename is not valid for the selected filesystem. Check its length, extension and drive syntax.",
"syntax": [
"FN ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"LOAD",
"SAVE"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "ERROR.FO",
"keyword": "FO",
"title": "FO — Field overflow",
"category": "Errors",
"dialect": "disk",
"summary": "FIELD definitions exceed the file buffer's record size.",
"syntax": [
"FO ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"FIELD",
"OPEN"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "FOR",
"keyword": "FOR",
"title": "FOR",
"category": "Program flow",
"dialect": "common",
"summary": "Start a counted loop.",
"syntax": [
"FOR variable = start TO finish [STEP increment]"
],
"parameters": [
"increment defaults to 1; a negative value counts downward.",
"NEXT closes the loop."
],
"sample": "FOR I=1 TO 5",
"exampleID": "count",
"related": [
"NEXT",
"TO",
"STEP"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "6"
},
{
"id": "FREE",
"keyword": "FREE",
"title": "FREE",
"category": "Disk files",
"dialect": "disk",
"summary": "Count free granules on a BASIC disk.",
"syntax": [
"FREE(drive)"
],
"parameters": [
"Granules are the BASIC filesystem's allocation units."
],
"sample": "PRINT FREE(0)",
"exampleID": null,
"related": [
"DIR"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "ERROR.FS",
"keyword": "FS",
"title": "FS — Bad file structure",
"category": "Errors",
"dialect": "disk",
"summary": "The disk file or filesystem structure is inconsistent with the requested operation.",
"syntax": [
"FS ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"DIR"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "GET",
"keyword": "GET",
"title": "GET",
"category": "Graphics",
"dialect": "common",
"summary": "Copy a PMODE rectangle into a numeric array.",
"syntax": [
"GET(x1,y1)-(x2,y2),array[,G]"
],
"parameters": [
"Dimension a two-dimensional array large enough for the rectangle.",
"G stores full graphics detail for PUT operations."
],
"sample": "GET(0,0)-(7,7),A,G",
"exampleID": null,
"related": [
"PUT",
"DISK.GET"
],
"notes": [
"GET #file,record is a different form for disk files."
],
"source": "basicGuide",
"sourcePage": "6"
},
{
"id": "DISK.GET",
"keyword": "GET",
"title": "GET — disk record",
"category": "Disk files",
"dialect": "disk",
"summary": "Read a direct-access record into its file buffer.",
"syntax": [
"GET #file[,record]"
],
"parameters": [
"Use OPEN \"D\" and FIELD to interpret the record.",
"An omitted record advances through the file."
],
"sample": "GET #1,3",
"exampleID": null,
"related": [
"FIELD",
"DISK.PUT",
"GET"
],
"notes": [
"This form is separate from graphics GET."
],
"source": "diskGuide",
"sourcePage": "4"
},
{
"id": "GO",
"keyword": "GO",
"title": "GO",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Prefix of GO TO and GO SUB; the joined forms are also accepted.",
"syntax": [
"GO TO line",
"GO SUB line"
],
"parameters": [],
"sample": "GO TO 100",
"exampleID": null,
"related": [
"GOTO",
"GOSUB"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "GOSUB",
"keyword": "GOSUB",
"title": "GOSUB",
"category": "Program flow",
"dialect": "common",
"summary": "Call a numbered subroutine and remember where to return.",
"syntax": [
"GOSUB line"
],
"parameters": [
"End the subroutine with RETURN.",
"Use the editor's Step Into, Step Over or Step Out to follow calls."
],
"sample": "GOSUB 100",
"exampleID": "subroutine",
"related": [
"RETURN",
"ON"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "6"
},
{
"id": "GOTO",
"keyword": "GOTO",
"title": "GOTO",
"category": "Program flow",
"dialect": "common",
"summary": "Continue execution at another numbered line.",
"syntax": [
"GOTO line"
],
"parameters": [
"line must exist in the loaded program."
],
"sample": "GOTO 100",
"exampleID": "branch",
"related": [
"GOSUB",
"ON",
"ERROR.UL"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "6"
},
{
"id": "HBUFF",
"keyword": "HBUFF",
"title": "HBUFF",
"category": "Graphics",
"dialect": "common",
"summary": "Reserve a buffer for high-resolution GET/PUT graphics.",
"syntax": [
"HBUFF buffer,size"
],
"parameters": [
"size is the number of bytes to reserve; maximum 7931."
],
"sample": "HBUFF 1,200",
"exampleID": null,
"related": [
"HGET",
"HPUT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "6"
},
{
"id": "HCIRCLE",
"keyword": "HCIRCLE",
"title": "HCIRCLE",
"category": "Graphics",
"dialect": "common",
"summary": "Draw a high-resolution circle, ellipse or arc.",
"syntax": [
"HCIRCLE(x,y),radius[,color[,ratio[,start,end]]]"
],
"parameters": [
"Optional ratio changes the shape; start/end restrict the arc."
],
"sample": "HCIRCLE(160,96),30,3",
"exampleID": null,
"related": [
"HLINE",
"HPAINT",
"CIRCLE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "7"
},
{
"id": "HCLS",
"keyword": "HCLS",
"title": "HCLS",
"category": "Graphics",
"dialect": "common",
"summary": "Fill the CoCo 3 high-resolution graphics screen.",
"syntax": [
"HCLS [color]"
],
"parameters": [
"Omitting color uses the current background."
],
"sample": "HCLS 0",
"exampleID": "high-graphics",
"related": [
"HSCREEN",
"HCOLOR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "7"
},
{
"id": "HCOLOR",
"keyword": "HCOLOR",
"title": "HCOLOR",
"category": "Graphics",
"dialect": "common",
"summary": "Choose foreground and background palette entries for high-resolution graphics.",
"syntax": [
"HCOLOR foreground,background"
],
"parameters": [
"Use palette entries available in the selected HSCREEN mode."
],
"sample": "HCOLOR 3,0",
"exampleID": null,
"related": [
"HSCREEN",
"PALETTE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "7"
},
{
"id": "HDRAW",
"keyword": "HDRAW",
"title": "HDRAW",
"category": "Graphics",
"dialect": "common",
"summary": "Use a movement string to draw high-resolution graphics.",
"syntax": [
"HDRAW string"
],
"parameters": [
"Uses the movement commands described under DRAW."
],
"sample": "HDRAW \"BM40,40;R30;D30;L30;U30\"",
"exampleID": null,
"related": [
"DRAW",
"HLINE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "7"
},
{
"id": "HEX$",
"keyword": "HEX$",
"title": "HEX$",
"category": "Strings",
"dialect": "common",
"summary": "Convert a number to hexadecimal text.",
"syntax": [
"HEX$(number)"
],
"parameters": [
"The returned string has no &H prefix."
],
"sample": "PRINT HEX$(255)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "HGET",
"keyword": "HGET",
"title": "HGET",
"category": "Graphics",
"dialect": "common",
"summary": "Save a high-resolution rectangle in an HBUFF buffer.",
"syntax": [
"HGET(x1,y1)-(x2,y2),buffer"
],
"parameters": [
"Reserve sufficient space with HBUFF before copying."
],
"sample": "HGET(0,0)-(7,7),1",
"exampleID": null,
"related": [
"HBUFF",
"HPUT",
"GET"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "8"
},
{
"id": "HLINE",
"keyword": "HLINE",
"title": "HLINE",
"category": "Graphics",
"dialect": "common",
"summary": "Draw a high-resolution line or rectangle.",
"syntax": [
"HLINE [(x1,y1)]-(x2,y2),color[,B or BF]"
],
"parameters": [
"B draws a box; BF fills it.",
"color may be a palette entry, PSET or PRESET."
],
"sample": "HLINE(10,10)-(100,70),3,BF",
"exampleID": null,
"related": [
"HSET",
"HCIRCLE",
"LINE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "8"
},
{
"id": "ERROR.HP",
"keyword": "HP",
"title": "HP — High-resolution print error",
"category": "Errors",
"dialect": "common",
"summary": "The requested high-resolution text operation is invalid. Check the display mode and coordinates.",
"syntax": [
"HP ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"HPRINT",
"HSCREEN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "HPAINT",
"keyword": "HPAINT",
"title": "HPAINT",
"category": "Graphics",
"dialect": "common",
"summary": "Fill a bounded high-resolution region.",
"syntax": [
"HPAINT(x,y)[,color[,border]]"
],
"parameters": [
"Select a point inside a closed border."
],
"sample": "HPAINT(160,96),3,3",
"exampleID": null,
"related": [
"HCIRCLE",
"HLINE",
"PAINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "8"
},
{
"id": "HPOINT",
"keyword": "HPOINT",
"title": "HPOINT",
"category": "Graphics",
"dialect": "common",
"summary": "Read the color of a high-resolution graphics point.",
"syntax": [
"HPOINT(x,y)"
],
"parameters": [
"Coordinates follow the selected HSCREEN mode."
],
"sample": "A=HPOINT(20,20)",
"exampleID": "high-graphics",
"related": [
"HSET"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "HPRINT",
"keyword": "HPRINT",
"title": "HPRINT",
"category": "Graphics",
"dialect": "common",
"summary": "Draw text in a CoCo 3 high-resolution graphics display.",
"syntax": [
"HPRINT(column,row),string"
],
"parameters": [
"Coordinates select character cells, not individual pixels."
],
"sample": "HPRINT(2,2),\"COCO\"",
"exampleID": null,
"related": [
"HSCREEN",
"HCOLOR",
"PRINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "8"
},
{
"id": "HPUT",
"keyword": "HPUT",
"title": "HPUT",
"category": "Graphics",
"dialect": "common",
"summary": "Restore a high-resolution rectangle from a buffer.",
"syntax": [
"HPUT(x1,y1)-(x2,y2),buffer,action"
],
"parameters": [
"action: PSET, PRESET, AND, OR or NOT."
],
"sample": "HPUT(10,10)-(17,17),1,PSET",
"exampleID": null,
"related": [
"HBUFF",
"HGET",
"PUT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "9"
},
{
"id": "ERROR.HR",
"keyword": "HR",
"title": "HR — High-resolution graphics error",
"category": "Errors",
"dialect": "common",
"summary": "A CoCo 3 graphics argument or buffer is invalid. Check coordinates, mode and allocated buffer size.",
"syntax": [
"HR ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"HSCREEN",
"HBUFF",
"HGET",
"HPUT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "HRESET",
"keyword": "HRESET",
"title": "HRESET",
"category": "Graphics",
"dialect": "common",
"summary": "Reset a high-resolution point to the background.",
"syntax": [
"HRESET(x,y)"
],
"parameters": [],
"sample": "HRESET(20,20)",
"exampleID": null,
"related": [
"HSET",
"HPOINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "9"
},
{
"id": "HSCREEN",
"keyword": "HSCREEN",
"title": "HSCREEN",
"category": "Graphics",
"dialect": "common",
"summary": "Select a CoCo 3 high-resolution graphics display.",
"syntax": [
"HSCREEN mode"
],
"parameters": [
"0: return to low-resolution display.",
"1: 320x192, 4 colors; 2: 320x192, 16 colors.",
"3: 640x192, 2 colors; 4: 640x192, 4 colors.",
"Selecting modes 1-4 also clears that graphics display."
],
"sample": "HSCREEN 2",
"exampleID": "high-graphics",
"related": [
"HCLS",
"HCOLOR",
"PALETTE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "9"
},
{
"id": "HSET",
"keyword": "HSET",
"title": "HSET",
"category": "Graphics",
"dialect": "common",
"summary": "Set a point in CoCo 3 high-resolution graphics.",
"syntax": [
"HSET(x,y[,color])"
],
"parameters": [
"Omitting color uses the foreground.",
"Coordinates depend on the HSCREEN resolution."
],
"sample": "HSET(20,20,3)",
"exampleID": "high-graphics",
"related": [
"HRESET",
"HPOINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "9"
},
{
"id": "HSTAT",
"keyword": "HSTAT",
"title": "HSTAT",
"category": "Text and output",
"dialect": "common",
"summary": "Read the high-resolution text character, attributes and cursor coordinates.",
"syntax": [
"HSTAT character,attribute,column,row"
],
"parameters": [
"Supply numeric variables to receive the four results."
],
"sample": "HSTAT C,A,X,Y",
"exampleID": null,
"related": [
"LOCATE",
"ATTR",
"WIDTH"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "9"
},
{
"id": "ERROR.ID",
"keyword": "ID",
"title": "ID — Illegal direct statement",
"category": "Errors",
"dialect": "common",
"summary": "This statement requires execution from a numbered program rather than the immediate prompt.",
"syntax": [
"ID ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"RUN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "ERROR.IE",
"keyword": "IE",
"title": "IE — Input past end",
"category": "Errors",
"dialect": "common",
"summary": "The program tried to read beyond the end of a file. Test EOF before requesting another item.",
"syntax": [
"IE ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"EOF"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "IF",
"keyword": "IF",
"title": "IF",
"category": "Program flow",
"dialect": "common",
"summary": "Choose statements or a destination line according to a test.",
"syntax": [
"IF condition THEN statements [ELSE statements]",
"IF condition THEN line [ELSE line]"
],
"parameters": [
"Zero is false; a nonzero value is true.",
"A false condition skips the remainder of its branch on that BASIC line."
],
"sample": "IF A=42 THEN PRINT \"YES\" ELSE PRINT \"NO\"",
"exampleID": "branch",
"related": [
"THEN",
"ELSE",
"AND",
"OR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "9"
},
{
"id": "INKEY$",
"keyword": "INKEY$",
"title": "INKEY$",
"category": "Input",
"dialect": "common",
"summary": "Read a waiting key without stopping for input.",
"syntax": [
"INKEY$"
],
"parameters": [
"The result is an empty string when no key is waiting."
],
"sample": "A$=INKEY$",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "INPUT",
"keyword": "INPUT",
"title": "INPUT",
"category": "Input",
"dialect": "common",
"summary": "Read keyboard values into numeric or string variables.",
"syntax": [
"INPUT [\"prompt\";] variable [, variable ...]"
],
"parameters": [
"Separate multiple responses with commas.",
"Use LINE INPUT when a whole line, including commas, belongs in one string."
],
"sample": "INPUT \"YOUR NAME\";N$",
"exampleID": null,
"related": [
"LINE.INPUT",
"INKEY$"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "10"
},
{
"id": "DISK.INPUT",
"keyword": "INPUT",
"title": "INPUT — disk file",
"category": "Disk files",
"dialect": "disk",
"summary": "Read delimited values from an open input file.",
"syntax": [
"INPUT #file,variable[,variable ...]"
],
"parameters": [
"Variable types must match the stored fields."
],
"sample": "INPUT #1,A,N$",
"exampleID": null,
"related": [
"OPEN",
"WRITE",
"EOF"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "INSTR",
"keyword": "INSTR",
"title": "INSTR",
"category": "Strings",
"dialect": "common",
"summary": "Find the first occurrence of a substring.",
"syntax": [
"INSTR([start,]string,target)"
],
"parameters": [
"Positions start at 1; a zero result means no match."
],
"sample": "PRINT INSTR(\"COMPUTER\",\"PUT\")",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "INT",
"keyword": "INT",
"title": "INT",
"category": "Math",
"dialect": "common",
"summary": "Round down to an integer, including for negative values.",
"syntax": [
"INT(number)"
],
"parameters": [
"INT(-2.7) is -3."
],
"sample": "PRINT INT(-2.7)",
"exampleID": "math",
"related": [
"FIX"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "ERROR.IO",
"keyword": "IO",
"title": "IO — Input/output error",
"category": "Errors",
"dialect": "common",
"summary": "The requested media operation failed. Check mounting, format, filename and the selected drive.",
"syntax": [
"IO ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"DIR",
"DRIVE",
"CLOAD"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "JOYSTK",
"keyword": "JOYSTK",
"title": "JOYSTK",
"category": "Input",
"dialect": "common",
"summary": "Read an emulated joystick axis.",
"syntax": [
"JOYSTK(axis)"
],
"parameters": [
"0: right X; 1: right Y; 2: left X; 3: left Y.",
"Values range from 0 to 63; center is about 31."
],
"sample": "PRINT JOYSTK(2)",
"exampleID": null,
"related": [
"BUTTON"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "19"
},
{
"id": "KILL",
"keyword": "KILL",
"title": "KILL",
"category": "Disk files",
"dialect": "disk",
"summary": "Remove a file from a BASIC disk directory.",
"syntax": [
"KILL \"filename/ext[:drive]\""
],
"parameters": [
"Include the extension."
],
"sample": "KILL \"OLD/BAS:0\"",
"exampleID": null,
"related": [
"DIR",
"RENAME"
],
"notes": [
"Deletes the file from the selected disk; the command has no Undo."
],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "LEFT$",
"keyword": "LEFT$",
"title": "LEFT$",
"category": "Strings",
"dialect": "common",
"summary": "Take characters from the beginning of a string.",
"syntax": [
"LEFT$(string,count)"
],
"parameters": [
"count is the maximum number of characters returned."
],
"sample": "PRINT LEFT$(\"COMPUTER\",3)",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "LEN",
"keyword": "LEN",
"title": "LEN",
"category": "Strings",
"dialect": "common",
"summary": "Count the characters in a string.",
"syntax": [
"LEN(string)"
],
"parameters": [],
"sample": "PRINT LEN(\"COCO\")",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "LET",
"keyword": "LET",
"title": "LET",
"category": "Variables and arrays",
"dialect": "common",
"summary": "Assign a value to a variable; LET is optional.",
"syntax": [
"[LET] variable = expression"
],
"parameters": [
"Use a name ending in $ for a string.",
"Only the first two characters of a variable name distinguish it in this BASIC."
],
"sample": "A=6*7",
"exampleID": "math",
"related": [
"DIM"
],
"notes": [
"Changing source in the editor does not change variables in a running CoCo program."
],
"source": "basicGuide",
"sourcePage": "10"
},
{
"id": "LINE",
"keyword": "LINE",
"title": "LINE",
"category": "Graphics",
"dialect": "common",
"summary": "Draw a PMODE line, rectangle or filled rectangle.",
"syntax": [
"LINE [(x1,y1)]-(x2,y2),action[,B or BF]"
],
"parameters": [
"action is PSET or PRESET; B draws a rectangle and BF fills it.",
"If the first point is omitted, drawing starts at the previous endpoint.",
"B or BF can be used with either PSET or PRESET."
],
"sample": "LINE (10,10)-(80,60),PSET,BF",
"exampleID": null,
"related": [
"PSET",
"CIRCLE",
"HLINE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "10"
},
{
"id": "LINE.INPUT",
"keyword": "LINE INPUT",
"title": "LINE INPUT",
"category": "Input",
"dialect": "common",
"summary": "Read an entire line into a string variable.",
"syntax": [
"LINE INPUT [\"prompt\";] stringVariable"
],
"parameters": [
"Commas in the entered line remain part of the string."
],
"sample": "LINE INPUT \"MESSAGE\";M$",
"exampleID": null,
"related": [
"INPUT",
"DISK.LINE.INPUT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "10"
},
{
"id": "DISK.LINE.INPUT",
"keyword": "LINE INPUT",
"title": "LINE INPUT — disk file",
"category": "Disk files",
"dialect": "disk",
"summary": "Read an entire file line into one string.",
"syntax": [
"LINE INPUT #file,stringVariable"
],
"parameters": [
"Commas remain part of the string."
],
"sample": "LINE INPUT #1,A$",
"exampleID": null,
"related": [
"OPEN",
"EOF",
"LINE.INPUT"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "LIST",
"keyword": "LIST",
"title": "LIST",
"category": "Source editing",
"dialect": "common",
"summary": "Display a program or a range of BASIC lines.",
"syntax": [
"LIST [first[-last]]",
"LIST -last",
"LIST first-"
],
"parameters": [
"A single line number lists only that line."
],
"sample": "LIST 100-200",
"exampleID": null,
"related": [
"LLIST",
"EDIT"
],
"notes": [
"Read from CoCo brings program text into the native editor without typing LIST."
],
"source": "basicGuide",
"sourcePage": "11"
},
{
"id": "LLIST",
"keyword": "LLIST",
"title": "LLIST",
"category": "Text and output",
"dialect": "common",
"summary": "Send a program listing to the printer device.",
"syntax": [
"LLIST [first[-last]]"
],
"parameters": [],
"sample": "LLIST 100-200",
"exampleID": null,
"related": [
"LIST",
"PRINT"
],
"notes": [
"Enable VCC Plus Printer Output capture to collect printer text."
],
"source": "basicGuide",
"sourcePage": "11"
},
{
"id": "LOAD",
"keyword": "LOAD",
"title": "LOAD",
"category": "Disk files",
"dialect": "disk",
"summary": "Load a BASIC program from disk.",
"syntax": [
"LOAD \"filename\"[,R]"
],
"parameters": [
"R runs the program after loading.",
"A :drive suffix selects a drive instead of the default."
],
"sample": "LOAD \"HELLO:0\"",
"exampleID": null,
"related": [
"SAVE",
"DISK.RUN"
],
"notes": [
"Loading replaces the BASIC program in CoCo memory."
],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "LOADM",
"keyword": "LOADM",
"title": "LOADM",
"category": "Disk files",
"dialect": "disk",
"summary": "Load a machine-language file from disk.",
"syntax": [
"LOADM \"filename\"[,offset]"
],
"parameters": [
"offset changes where bytes are loaded; internal machine-code addresses are not relocated."
],
"sample": "LOADM \"DEMO:0\"",
"exampleID": null,
"related": [
"EXEC",
"SAVEM"
],
"notes": [
"Use EXEC after loading unless the file implements its own autostart."
],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "LOC",
"keyword": "LOC",
"title": "LOC",
"category": "Disk files",
"dialect": "disk",
"summary": "Read the current record number for an open disk file.",
"syntax": [
"LOC(file)"
],
"parameters": [
"file refers to an open disk buffer."
],
"sample": "PRINT LOC(1)",
"exampleID": null,
"related": [
"OPEN",
"LOF"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "LOCATE",
"keyword": "LOCATE",
"title": "LOCATE",
"category": "Text and output",
"dialect": "common",
"summary": "Position the cursor in the CoCo 3 high-resolution text screen.",
"syntax": [
"LOCATE column,row"
],
"parameters": [
"Coordinates start at zero."
],
"sample": "WIDTH 80:LOCATE 10,5:PRINT \"COCO\"",
"exampleID": null,
"related": [
"WIDTH",
"ATTR",
"HSTAT"
],
"notes": [
"Use WIDTH 40 or WIDTH 80 first."
],
"source": "basicGuide",
"sourcePage": "11"
},
{
"id": "LOF",
"keyword": "LOF",
"title": "LOF",
"category": "Disk files",
"dialect": "disk",
"summary": "Read the highest record number in an open disk file.",
"syntax": [
"LOF(file)"
],
"parameters": [
"This is a record count, not a Mac file-size query."
],
"sample": "PRINT LOF(1)",
"exampleID": null,
"related": [
"OPEN",
"LOC"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "LOG",
"keyword": "LOG",
"title": "LOG",
"category": "Math",
"dialect": "common",
"summary": "Return the natural logarithm.",
"syntax": [
"LOG(number)"
],
"parameters": [
"number must be positive."
],
"sample": "PRINT LOG(1)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "LPEEK",
"keyword": "LPEEK",
"title": "LPEEK",
"category": "Memory",
"dialect": "common",
"summary": "Read a byte using the CoCo 3 long-memory interface.",
"syntax": [
"LPEEK(address)"
],
"parameters": [
"address: 0-524287. This BASIC interface is limited to 512 KB."
],
"sample": "PRINT LPEEK(&H70000)",
"exampleID": null,
"related": [
"LPOKE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "LPOKE",
"keyword": "LPOKE",
"title": "LPOKE",
"category": "Memory",
"dialect": "common",
"summary": "Write a byte using the CoCo 3 BASIC long-memory interface.",
"syntax": [
"LPOKE address,value"
],
"parameters": [
"address: 0-524287; value: 0-255.",
"This command's address range does not expand simply because the emulator has more RAM."
],
"sample": "LPOKE &H70000,65",
"exampleID": null,
"related": [
"LPEEK",
"POKE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "11"
},
{
"id": "ERROR.LS",
"keyword": "LS",
"title": "LS — String too long",
"category": "Errors",
"dialect": "common",
"summary": "The result exceeds BASIC's maximum string length of 255 characters.",
"syntax": [
"LS ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"LEN",
"LEFT$",
"MID$"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "LSET",
"keyword": "LSET",
"title": "LSET",
"category": "Disk files",
"dialect": "disk",
"summary": "Left-align text in a direct-access field.",
"syntax": [
"LSET stringField = string"
],
"parameters": [
"Short strings are padded; long strings are limited to the field length."
],
"sample": "LSET N$=\"COCO\"",
"exampleID": null,
"related": [
"FIELD",
"RSET"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "MEM",
"keyword": "MEM",
"title": "MEM",
"category": "Memory",
"dialect": "common",
"summary": "Report currently free BASIC memory.",
"syntax": [
"MEM"
],
"parameters": [
"Available BASIC workspace is not the same as the selected total machine RAM."
],
"sample": "PRINT MEM",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "MERGE",
"keyword": "MERGE",
"title": "MERGE",
"category": "Disk files",
"dialect": "disk",
"summary": "Combine a disk ASCII listing with the program in memory.",
"syntax": [
"MERGE \"filename\"[,R]"
],
"parameters": [
"Save the source file with SAVE ...,A first.",
"R starts the merged program."
],
"sample": "MERGE \"SUBS:0\"",
"exampleID": null,
"related": [
"LOAD",
"SAVE"
],
"notes": [
"Duplicate line numbers are replaced by the incoming lines."
],
"source": "diskGuide",
"sourcePage": "5"
},
{
"id": "MID$",
"keyword": "MID$",
"title": "MID$",
"category": "Strings",
"dialect": "common",
"summary": "Read a substring, or replace characters in a string variable.",
"syntax": [
"MID$(string,start[,count])",
"MID$(stringVariable,start[,count]) = replacement"
],
"parameters": [
"Positions start at 1.",
"Without count, the function reads to the end.",
"Assignment changes existing characters; it does not insert new space."
],
"sample": "PRINT MID$(\"COMPUTER\",4,3)",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "11, 20"
},
{
"id": "MKN$",
"keyword": "MKN$",
"title": "MKN$",
"category": "Disk files",
"dialect": "disk",
"summary": "Encode a BASIC number into its five-byte representation.",
"syntax": [
"MKN$(number)"
],
"parameters": [
"Use with fixed-length binary fields; this is not decimal text."
],
"sample": "A$=MKN$(42)",
"exampleID": null,
"related": [
"CVN",
"FIELD"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "6"
},
{
"id": "MOTOR",
"keyword": "MOTOR",
"title": "MOTOR",
"category": "Cassette",
"dialect": "common",
"summary": "Control the cassette motor signal.",
"syntax": [
"MOTOR ON",
"MOTOR OFF"
],
"parameters": [],
"sample": "MOTOR OFF",
"exampleID": null,
"related": [
"AUDIO",
"CLOAD",
"CSAVE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "12"
},
{
"id": "ERROR.NE",
"keyword": "NE",
"title": "NE — File not found",
"category": "Errors",
"dialect": "disk",
"summary": "The named disk file was not found on the selected drive. Check DIR, extension and drive suffix.",
"syntax": [
"NE ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"DIR",
"LOAD",
"DRIVE"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "NEW",
"keyword": "NEW",
"title": "NEW",
"category": "Source editing",
"dialect": "common",
"summary": "Erase the program currently held by BASIC.",
"syntax": [
"NEW"
],
"parameters": [],
"sample": "NEW",
"exampleID": null,
"related": [
"CLEAR",
"RUN"
],
"notes": [
"This changes CoCo memory, not a saved Mac source file."
],
"source": "basicGuide",
"sourcePage": "12"
},
{
"id": "NEXT",
"keyword": "NEXT",
"title": "NEXT",
"category": "Program flow",
"dialect": "common",
"summary": "Advance a FOR loop and test whether it should repeat.",
"syntax": [
"NEXT [variable [, variable ...]]"
],
"parameters": [
"For nested loops, close the innermost loop first."
],
"sample": "NEXT I",
"exampleID": "count",
"related": [
"FOR",
"ERROR.NF"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "12"
},
{
"id": "ERROR.NF",
"keyword": "NF",
"title": "NF — NEXT without FOR",
"category": "Errors",
"dialect": "common",
"summary": "Execution reached NEXT without a matching active loop. Check loop entry paths.",
"syntax": [
"NF ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"FOR",
"NEXT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "ERROR.NO",
"keyword": "NO",
"title": "NO — File not open",
"category": "Errors",
"dialect": "common",
"summary": "Open the file before reading, writing or requesting its records.",
"syntax": [
"NO ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"OPEN",
"CLOSE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "NOT",
"keyword": "NOT",
"title": "NOT",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Invert an integer bit pattern or a BASIC truth value.",
"syntax": [
"NOT expression"
],
"parameters": [],
"sample": "IF NOT A=0 THEN PRINT \"NONZERO\"",
"exampleID": null,
"related": [
"AND",
"OR",
"IF"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ERROR.OB",
"keyword": "OB",
"title": "OB — Out of buffers",
"category": "Errors",
"dialect": "disk",
"summary": "No suitable disk buffer is available. Allocate the required file buffers before opening files.",
"syntax": [
"OB ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"FILES",
"OPEN"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "ERROR.OD",
"keyword": "OD",
"title": "OD — Out of DATA",
"category": "Errors",
"dialect": "common",
"summary": "READ requested more values than the DATA statements provide.",
"syntax": [
"OD ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"DATA",
"READ",
"RESTORE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "OFF",
"keyword": "OFF",
"title": "OFF",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Disable a feature in commands that accept an ON/OFF switch.",
"syntax": [
"AUDIO OFF",
"MOTOR OFF",
"VERIFY OFF"
],
"parameters": [],
"sample": "MOTOR OFF",
"exampleID": null,
"related": [
"AUDIO",
"MOTOR",
"VERIFY"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ERROR.OM",
"keyword": "OM",
"title": "OM — Out of memory",
"category": "Errors",
"dialect": "common",
"summary": "BASIC has insufficient workspace for the operation. Check arrays, strings, graphics pages and program size.",
"syntax": [
"OM ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"MEM",
"CLEAR",
"DIM",
"PCLEAR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "ON",
"keyword": "ON",
"title": "ON",
"category": "Program flow",
"dialect": "common",
"summary": "Select a GOTO or GOSUB destination by its position in a list.",
"syntax": [
"ON expression GOTO line [, line ...]",
"ON expression GOSUB line [, line ...]"
],
"parameters": [
"A value of 1 selects the first destination.",
"Zero or a value beyond the list falls through."
],
"sample": "ON N GOSUB 100,200,300",
"exampleID": "branch",
"related": [
"GOTO",
"GOSUB",
"ON.ERR",
"ON.BRK"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "12"
},
{
"id": "ON.BRK",
"keyword": "ON BRK",
"title": "ON BRK",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Branch to a handler when the CoCo Break key is pressed.",
"syntax": [
"ON BRK GOTO line"
],
"parameters": [
"CoCo 3 extension.",
"ON BRK GOTO 0 restores ordinary Break handling."
],
"sample": "ON BRK GOTO 200",
"exampleID": null,
"related": [
"STOP",
"ON.ERR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "12"
},
{
"id": "ON.ERR",
"keyword": "ON ERR",
"title": "ON ERR",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Send runtime errors to a BASIC handler on the CoCo 3.",
"syntax": [
"ON ERR GOTO line"
],
"parameters": [
"Use ERNO and ERLIN in the handler to identify the error.",
"ON ERR GOTO 0 disables the handler."
],
"sample": "ON ERR GOTO 100",
"exampleID": "error-trap",
"related": [
"ERNO",
"ERLIN",
"ERROR.SN"
],
"notes": [
"Handled errors remain under BASIC control; VCC Plus does not replace them with its unhandled-error pause."
],
"source": "basicGuide",
"sourcePage": "12"
},
{
"id": "OPEN",
"keyword": "OPEN",
"title": "OPEN",
"category": "Disk files",
"dialect": "disk",
"summary": "Open a data stream to a file or device.",
"syntax": [
"OPEN \"mode\",#file,\"filename\"[,recordLength]"
],
"parameters": [
"I reads sequential data; O writes sequential data; D selects direct-access disk records.",
"Disk file numbers: 1-15, subject to FILES allocation.",
"Device -1 is cassette; -2 is printer; 0 is console."
],
"sample": "OPEN \"I\",#1,\"DATA/TXT:0\"",
"exampleID": null,
"related": [
"CLOSE",
"FILES",
"FIELD"
],
"notes": [
"O can replace an existing file; use a disposable output filename while learning."
],
"source": "diskGuide",
"sourcePage": "6"
},
{
"id": "OR",
"keyword": "OR",
"title": "OR",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Combine conditions or integer bit patterns when either side is set.",
"syntax": [
"expression OR expression"
],
"parameters": [],
"sample": "IF A=0 OR B=0 THEN PRINT \"ZERO\"",
"exampleID": null,
"related": [
"AND",
"NOT",
"IF"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "ERROR.OS",
"keyword": "OS",
"title": "OS — Out of string space",
"category": "Errors",
"dialect": "common",
"summary": "The reserved string workspace is exhausted. Consider reserving more with CLEAR before creating data.",
"syntax": [
"OS ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"CLEAR",
"LEN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "ERROR.OV",
"keyword": "OV",
"title": "OV — Overflow",
"category": "Errors",
"dialect": "common",
"summary": "A numeric result is too large for BASIC to represent.",
"syntax": [
"OV ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"EXP"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "PAINT",
"keyword": "PAINT",
"title": "PAINT",
"category": "Graphics",
"dialect": "common",
"summary": "Fill a bounded PMODE area from a starting point.",
"syntax": [
"PAINT(x,y)[,color[,border]]"
],
"parameters": [
"The starting point must be inside a closed border for a bounded fill."
],
"sample": "PAINT(128,96),1,1",
"exampleID": null,
"related": [
"CIRCLE",
"LINE",
"HPAINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "13"
},
{
"id": "PALETTE",
"keyword": "PALETTE",
"title": "PALETTE",
"category": "Graphics",
"dialect": "common",
"summary": "Assign a CoCo 3 palette entry or restore a standard palette.",
"syntax": [
"PALETTE register,color",
"PALETTE CMP",
"PALETTE RGB"
],
"parameters": [
"register: 0-15; color: 0-63.",
"CMP and RGB choose standard tables for the corresponding monitor signal."
],
"sample": "PALETTE 1,13",
"exampleID": null,
"related": [
"HSCREEN",
"HCOLOR",
"CMP",
"RGB"
],
"notes": [
"The BASIC palette and VCC Plus Video Signal setting are related but separate controls."
],
"source": "basicGuide",
"sourcePage": "13"
},
{
"id": "PCLEAR",
"keyword": "PCLEAR",
"title": "PCLEAR",
"category": "Graphics",
"dialect": "common",
"summary": "Reserve 1.5 KB pages for PMODE graphics.",
"syntax": [
"PCLEAR pages"
],
"parameters": [
"Reserve enough pages for the chosen PMODE and starting page."
],
"sample": "PCLEAR 4",
"exampleID": "low-graphics",
"related": [
"PMODE",
"PCOPY",
"MEM"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "13"
},
{
"id": "PCLS",
"keyword": "PCLS",
"title": "PCLS",
"category": "Graphics",
"dialect": "common",
"summary": "Fill the current PMODE graphics screen.",
"syntax": [
"PCLS [color]"
],
"parameters": [
"Omitting color uses the current background."
],
"sample": "PCLS 0",
"exampleID": "low-graphics",
"related": [
"PMODE",
"COLOR",
"CLS"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "13"
},
{
"id": "PCOPY",
"keyword": "PCOPY",
"title": "PCOPY",
"category": "Graphics",
"dialect": "common",
"summary": "Copy one reserved PMODE graphics page to another.",
"syntax": [
"PCOPY source TO destination"
],
"parameters": [
"Pages must have been reserved with PCLEAR."
],
"sample": "PCOPY 1 TO 2",
"exampleID": null,
"related": [
"PCLEAR",
"PMODE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "13"
},
{
"id": "PEEK",
"keyword": "PEEK",
"title": "PEEK",
"category": "Memory",
"dialect": "common",
"summary": "Read a byte through the current CPU memory map.",
"syntax": [
"PEEK(address)"
],
"parameters": [
"address: 0-65535.",
"Reading device registers can affect the device."
],
"sample": "PRINT PEEK(&H400)",
"exampleID": null,
"related": [
"POKE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "PLAY",
"keyword": "PLAY",
"title": "PLAY",
"category": "Sound",
"dialect": "common",
"summary": "Play notes described by a music string.",
"syntax": [
"PLAY string"
],
"parameters": [
"A-G name notes; O selects octave, L note length and T tempo.",
"# or + sharpens a note; - flattens it; P inserts a pause."
],
"sample": "PLAY \"T120O3L8CEG\"",
"exampleID": null,
"related": [
"SOUND"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "13"
},
{
"id": "PMODE",
"keyword": "PMODE",
"title": "PMODE",
"category": "Graphics",
"dialect": "common",
"summary": "Choose the resolution and starting page for traditional CoCo graphics.",
"syntax": [
"PMODE mode,page"
],
"parameters": [
"0: 128x96, 2 colors; 1: 128x96, 4 colors.",
"2: 128x192, 2 colors; 3: 128x192, 4 colors.",
"4: 256x192, 2 colors."
],
"sample": "PMODE 4,1",
"exampleID": "low-graphics",
"related": [
"PCLEAR",
"SCREEN",
"PCLS"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "14"
},
{
"id": "POINT",
"keyword": "POINT",
"title": "POINT",
"category": "Graphics",
"dialect": "common",
"summary": "Read a semigraphics block on the text screen.",
"syntax": [
"POINT(x,y)"
],
"parameters": [
"-1 indicates part of an ordinary text character; otherwise the result describes the block color."
],
"sample": "PRINT POINT(10,10)",
"exampleID": null,
"related": [
"SET"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "POKE",
"keyword": "POKE",
"title": "POKE",
"category": "Memory",
"dialect": "common",
"summary": "Write one byte through the current CPU memory map.",
"syntax": [
"POKE address,value"
],
"parameters": [
"address: 0-65535; value: 0-255."
],
"sample": "POKE &H400,65",
"exampleID": null,
"related": [
"PEEK",
"LPOKE"
],
"notes": [
"Writes can change programs, device registers or system state. Use only addresses you understand."
],
"source": "basicGuide",
"sourcePage": "14"
},
{
"id": "POS",
"keyword": "POS",
"title": "POS",
"category": "Text and output",
"dialect": "common",
"summary": "Read the current print-column position for a device.",
"syntax": [
"POS(device)"
],
"parameters": [
"device 0 is the screen; -2 is the printer."
],
"sample": "PRINT POS(0)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "20"
},
{
"id": "PPOINT",
"keyword": "PPOINT",
"title": "PPOINT",
"category": "Graphics",
"dialect": "common",
"summary": "Read the color of a PMODE graphics point.",
"syntax": [
"PPOINT(x,y)"
],
"parameters": [],
"sample": "PRINT PPOINT(20,20)",
"exampleID": "low-graphics",
"related": [
"PSET"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "PRESET",
"keyword": "PRESET",
"title": "PRESET",
"category": "Graphics",
"dialect": "common",
"summary": "Reset a PMODE point to the background color.",
"syntax": [
"PRESET(x,y)"
],
"parameters": [],
"sample": "PRESET(20,20)",
"exampleID": null,
"related": [
"PSET",
"PPOINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "14"
},
{
"id": "PRINT",
"keyword": "PRINT",
"title": "PRINT",
"category": "Text and output",
"dialect": "common",
"summary": "Display values on the text screen.",
"syntax": [
"PRINT [expression [; or , expression] ...]"
],
"parameters": [
"Semicolon joins output without a print-zone advance.",
"Comma advances to the next print zone.",
"A trailing separator suppresses the usual newline."
],
"sample": "PRINT \"ANSWER=\";42",
"exampleID": "hello",
"related": [
"PRINT@",
"USING",
"TAB"
],
"notes": [
"? is a shorthand for PRINT."
],
"source": "basicGuide",
"sourcePage": "14-15"
},
{
"id": "DISK.PRINT",
"keyword": "PRINT",
"title": "PRINT — file or printer",
"category": "Disk files",
"dialect": "disk",
"summary": "Write formatted values to an open file or output device.",
"syntax": [
"PRINT #file,expression[; or , expression ...]"
],
"parameters": [
"-2 selects the printer; -1 selects cassette.",
"Positive file numbers refer to previously opened disk files."
],
"sample": "PRINT #-2,\"HELLO PRINTER\"",
"exampleID": null,
"related": [
"OPEN",
"CLOSE",
"WRITE",
"USING"
],
"notes": [
"Disk/cassette output writes media. Printer text is captured only when the VCC Plus printer is enabled."
],
"source": "diskGuide",
"sourcePage": "6-7"
},
{
"id": "PRINT.USING",
"keyword": "PRINT USING",
"title": "PRINT USING",
"category": "Text and output",
"dialect": "common",
"summary": "Print values with a reusable layout.",
"syntax": [
"PRINT USING \"format\";expression[;expression ...]"
],
"parameters": [
"Each # reserves a digit position; a decimal point places the fractional part.",
"For strings, ! prints one character and % followed by spaces and % defines a fixed-width field."
],
"sample": "PRINT USING \"###.##\";12.5",
"exampleID": "formatting",
"related": [
"PRINT",
"USING",
"TAB"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "15"
},
{
"id": "PRINT@",
"keyword": "PRINT@",
"title": "PRINT@",
"category": "Text and output",
"dialect": "common",
"summary": "Place text at a numbered position on the 32-column screen.",
"syntax": [
"PRINT @position, expression"
],
"parameters": [
"position: 0-511, counted across rows from the top left."
],
"sample": "PRINT @64,\"ROW THREE\"",
"exampleID": null,
"related": [
"PRINT",
"LOCATE",
"WIDTH"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "15"
},
{
"id": "PSET",
"keyword": "PSET",
"title": "PSET",
"category": "Graphics",
"dialect": "common",
"summary": "Set a point in the PMODE drawing area.",
"syntax": [
"PSET(x,y[,color])"
],
"parameters": [
"Drawing coordinates use x: 0-255 and y: 0-191.",
"Omit color to use the current foreground."
],
"sample": "PSET(20,20,1)",
"exampleID": "low-graphics",
"related": [
"PRESET",
"PPOINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "15"
},
{
"id": "PUT",
"keyword": "PUT",
"title": "PUT",
"category": "Graphics",
"dialect": "common",
"summary": "Draw a PMODE rectangle from a saved numeric array.",
"syntax": [
"PUT(x1,y1)-(x2,y2),array[,action]"
],
"parameters": [
"action: PSET, PRESET, AND, OR or NOT.",
"Use a matching rectangle and storage prepared by GET."
],
"sample": "PUT(10,10)-(17,17),A,PSET",
"exampleID": null,
"related": [
"GET",
"DISK.PUT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "15"
},
{
"id": "DISK.PUT",
"keyword": "PUT",
"title": "PUT — disk record",
"category": "Disk files",
"dialect": "disk",
"summary": "Write the file buffer as a direct-access record.",
"syntax": [
"PUT #file[,record]"
],
"parameters": [
"Use LSET/RSET to fill the buffer before writing."
],
"sample": "PUT #1,3",
"exampleID": null,
"related": [
"FIELD",
"DISK.GET",
"PUT"
],
"notes": [
"This changes the opened disk file. It is separate from graphics PUT."
],
"source": "diskGuide",
"sourcePage": "7"
},
{
"id": "READ",
"keyword": "READ",
"title": "READ",
"category": "Variables and arrays",
"dialect": "common",
"summary": "Take the next values from the program's DATA statements.",
"syntax": [
"READ variable [, variable ...]"
],
"parameters": [
"Variable type must match the corresponding value."
],
"sample": "READ A,N$",
"exampleID": "data",
"related": [
"DATA",
"RESTORE",
"ERROR.OD"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "15"
},
{
"id": "REM",
"keyword": "REM",
"title": "REM",
"category": "Source editing",
"dialect": "common",
"summary": "Add a comment that BASIC does not execute.",
"syntax": [
"REM comment"
],
"parameters": [],
"sample": "REM CALCULATE THE TOTAL",
"exampleID": null,
"related": [
"DATA"
],
"notes": [
"An apostrophe also starts a comment. Quoted strings and comments retain their entered case."
],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "RENAME",
"keyword": "RENAME",
"title": "RENAME",
"category": "Disk files",
"dialect": "disk",
"summary": "Change a filename within the same BASIC disk.",
"syntax": [
"RENAME \"old/ext[:drive]\" TO \"new/ext[:drive]\""
],
"parameters": [
"Include both extensions."
],
"sample": "RENAME \"OLD/BAS:0\" TO \"NEW/BAS:0\"",
"exampleID": null,
"related": [
"DIR",
"COPY"
],
"notes": [
"Changes the disk directory."
],
"source": "diskGuide",
"sourcePage": "7"
},
{
"id": "RENUM",
"keyword": "RENUM",
"title": "RENUM",
"category": "Source editing",
"dialect": "common",
"summary": "Renumber program lines and update recognized line references.",
"syntax": [
"RENUM [newStart [, oldStart [, increment]]]"
],
"parameters": [
"newStart is the first assigned number.",
"oldStart selects the first old line to change.",
"increment controls spacing."
],
"sample": "RENUM 100,0,10",
"exampleID": null,
"related": [
"LIST"
],
"notes": [
"The editor Renumber action supports Undo and updates editor source rather than the current CoCo program."
],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "RESET",
"keyword": "RESET",
"title": "RESET",
"category": "Graphics",
"dialect": "common",
"summary": "Clear a semigraphics block on the text screen.",
"syntax": [
"RESET(x,y)"
],
"parameters": [
"x: 0-63; y: 0-31."
],
"sample": "RESET(10,10)",
"exampleID": null,
"related": [
"SET",
"POINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "RESTORE",
"keyword": "RESTORE",
"title": "RESTORE",
"category": "Variables and arrays",
"dialect": "common",
"summary": "Move the DATA pointer back to the first item.",
"syntax": [
"RESTORE"
],
"parameters": [],
"sample": "RESTORE",
"exampleID": "data",
"related": [
"READ",
"DATA"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "RETURN",
"keyword": "RETURN",
"title": "RETURN",
"category": "Program flow",
"dialect": "common",
"summary": "Resume immediately after the matching GOSUB call.",
"syntax": [
"RETURN"
],
"parameters": [
"RETURN needs an active GOSUB call."
],
"sample": "RETURN",
"exampleID": "subroutine",
"related": [
"GOSUB",
"ERROR.RG"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "ERROR.RG",
"keyword": "RG",
"title": "RG — RETURN without GOSUB",
"category": "Errors",
"dialect": "common",
"summary": "There is no active subroutine call to return from. Avoid falling into a subroutine from the main program.",
"syntax": [
"RG ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"GOSUB",
"RETURN",
"END"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "RGB",
"keyword": "RGB",
"title": "RGB",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Restore the standard RGB palette on a CoCo 3.",
"syntax": [
"PALETTE RGB"
],
"parameters": [],
"sample": "PALETTE RGB",
"exampleID": null,
"related": [
"PALETTE",
"CMP"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "RIGHT$",
"keyword": "RIGHT$",
"title": "RIGHT$",
"category": "Strings",
"dialect": "common",
"summary": "Take characters from the end of a string.",
"syntax": [
"RIGHT$(string,count)"
],
"parameters": [
"count is the maximum number of characters returned."
],
"sample": "PRINT RIGHT$(\"COMPUTER\",3)",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "RND",
"keyword": "RND",
"title": "RND",
"category": "Math",
"dialect": "common",
"summary": "Generate a pseudo-random value.",
"syntax": [
"RND(limit)"
],
"parameters": [
"RND(0) returns a fractional value.",
"A positive integer limit returns an integer from 1 through limit."
],
"sample": "PRINT RND(6)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "RSET",
"keyword": "RSET",
"title": "RSET",
"category": "Disk files",
"dialect": "disk",
"summary": "Right-align text in a direct-access field.",
"syntax": [
"RSET stringField = string"
],
"parameters": [
"Short strings are padded on the left."
],
"sample": "RSET N$=\"42\"",
"exampleID": null,
"related": [
"FIELD",
"LSET"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "7"
},
{
"id": "RUN",
"keyword": "RUN",
"title": "RUN",
"category": "Program flow",
"dialect": "common",
"summary": "Start the program in memory, normally clearing its variables.",
"syntax": [
"RUN [line]"
],
"parameters": [
"Omit line to start at the beginning."
],
"sample": "RUN",
"exampleID": "hello",
"related": [
"END",
"DISK.RUN"
],
"notes": [
"Use the editor's Run button to transfer edited source and start it."
],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "DISK.RUN",
"keyword": "RUN",
"title": "RUN — disk file",
"category": "Disk files",
"dialect": "disk",
"summary": "Load and run a BASIC program from disk.",
"syntax": [
"RUN \"filename\"[,R]"
],
"parameters": [
"R preserves open files while chaining to the new program."
],
"sample": "RUN \"HELLO:0\"",
"exampleID": null,
"related": [
"LOAD",
"RUN"
],
"notes": [
"Replaces the in-memory BASIC program."
],
"source": "diskGuide",
"sourcePage": "8"
},
{
"id": "RGB.RUNM",
"keyword": "RUNM",
"title": "RUNM",
"category": "DOS differences",
"dialect": "rgbdos",
"summary": "Load and execute a machine-language program in one command.",
"syntax": [
"RUNM \"filename[:drive]\""
],
"parameters": [],
"sample": "RUNM \"HELLO:0\"",
"exampleID": null,
"related": [
"LOADM",
"EXEC"
],
"notes": [
"For binaries that start themselves during loading, use LOADM instead; RUNM can execute their entry point again."
],
"source": "rgbdos",
"sourcePage": "PDF page 6"
},
{
"id": "SAVE",
"keyword": "SAVE",
"title": "SAVE",
"category": "Disk files",
"dialect": "disk",
"summary": "Write the in-memory BASIC program to disk.",
"syntax": [
"SAVE \"filename\"[,A]"
],
"parameters": [
"A selects an ASCII listing instead of tokenized storage."
],
"sample": "SAVE \"HELLO:0\",A",
"exampleID": null,
"related": [
"LOAD",
"CSAVE"
],
"notes": [
"Writes to the selected image and may replace an existing file. The native editor Save command instead saves a Mac source file."
],
"source": "diskGuide",
"sourcePage": "8"
},
{
"id": "SAVEM",
"keyword": "SAVEM",
"title": "SAVEM",
"category": "Disk files",
"dialect": "disk",
"summary": "Write a memory range as a machine-language disk file.",
"syntax": [
"SAVEM \"filename\",first,last,entry"
],
"parameters": [
"first/last are inclusive addresses; entry is the default EXEC address."
],
"sample": "SAVEM \"DEMO:0\",&H5000,&H50FF,&H5000",
"exampleID": null,
"related": [
"LOADM",
"EXEC"
],
"notes": [
"Writes to the selected disk image."
],
"source": "diskGuide",
"sourcePage": "8"
},
{
"id": "SCREEN",
"keyword": "SCREEN",
"title": "SCREEN",
"category": "Graphics",
"dialect": "common",
"summary": "Switch between the traditional text and graphics displays.",
"syntax": [
"SCREEN type,colorSet"
],
"parameters": [
"type: 0 for text, 1 for PMODE graphics.",
"colorSet: 0 or 1."
],
"sample": "SCREEN 1,0",
"exampleID": "low-graphics",
"related": [
"PMODE",
"HSCREEN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "ERROR.SE",
"keyword": "SE",
"title": "SE — Not a field string",
"category": "Errors",
"dialect": "disk",
"summary": "LSET or RSET was given a string that is not currently mapped by FIELD.",
"syntax": [
"SE ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"FIELD",
"LSET",
"RSET"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "SET",
"keyword": "SET",
"title": "SET",
"category": "Graphics",
"dialect": "common",
"summary": "Color one semigraphics block on the 32-column text screen.",
"syntax": [
"SET(x,y,color)"
],
"parameters": [
"x: 0-63; y: 0-31; color: 0-8."
],
"sample": "SET(10,10,3)",
"exampleID": null,
"related": [
"RESET",
"POINT",
"PSET"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "16"
},
{
"id": "SGN",
"keyword": "SGN",
"title": "SGN",
"category": "Math",
"dialect": "common",
"summary": "Return -1, 0 or 1 for a negative, zero or positive number.",
"syntax": [
"SGN(number)"
],
"parameters": [],
"sample": "PRINT SGN(-7)",
"exampleID": "math",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "SIN",
"keyword": "SIN",
"title": "SIN",
"category": "Math",
"dialect": "common",
"summary": "Return the sine of an angle in radians.",
"syntax": [
"SIN(angle)"
],
"parameters": [
"A full turn is 2*PI radians; use a numeric value for PI."
],
"sample": "PRINT SIN(0)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "SKIPF",
"keyword": "SKIPF",
"title": "SKIPF",
"category": "Cassette",
"dialect": "common",
"summary": "Advance through a cassette file without loading it.",
"syntax": [
"SKIPF [\"filename\"]"
],
"parameters": [],
"sample": "SKIPF \"DEMO\"",
"exampleID": null,
"related": [
"CLOAD",
"CLOADM"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "17"
},
{
"id": "ERROR.SN",
"keyword": "SN",
"title": "SN — Syntax error",
"category": "Errors",
"dialect": "common",
"summary": "BASIC could not interpret a statement. Check spelling, punctuation, quotes and the command form.",
"syntax": [
"SN ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"PRINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "SOUND",
"keyword": "SOUND",
"title": "SOUND",
"category": "Sound",
"dialect": "common",
"summary": "Play a tone for a specified duration.",
"syntax": [
"SOUND pitch,duration"
],
"parameters": [
"pitch: 1-255; duration: 1-255."
],
"sample": "SOUND 100,10",
"exampleID": null,
"related": [
"PLAY",
"AUDIO"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "17"
},
{
"id": "SQR",
"keyword": "SQR",
"title": "SQR",
"category": "Math",
"dialect": "common",
"summary": "Return the nonnegative square root.",
"syntax": [
"SQR(number)"
],
"parameters": [
"number must be zero or positive."
],
"sample": "PRINT SQR(16)",
"exampleID": "math",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "ERROR.ST",
"keyword": "ST",
"title": "ST — String expression too complex",
"category": "Errors",
"dialect": "common",
"summary": "Simplify the expression by saving intermediate string results in variables.",
"syntax": [
"ST ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"LET",
"MID$"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "STEP",
"keyword": "STEP",
"title": "STEP",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Set the increment of a FOR loop.",
"syntax": [
"FOR variable=start TO finish STEP increment"
],
"parameters": [],
"sample": "FOR I=10 TO 2 STEP -2",
"exampleID": null,
"related": [
"FOR",
"NEXT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "STOP",
"keyword": "STOP",
"title": "STOP",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Stop execution and report the BASIC line.",
"syntax": [
"STOP"
],
"parameters": [],
"sample": "STOP",
"exampleID": null,
"related": [
"CONT",
"END"
],
"notes": [
"A BASIC STOP is distinct from an editor breakpoint."
],
"source": "basicGuide",
"sourcePage": "17"
},
{
"id": "STR$",
"keyword": "STR$",
"title": "STR$",
"category": "Strings",
"dialect": "common",
"summary": "Convert a number into a printable string.",
"syntax": [
"STR$(number)"
],
"parameters": [
"Positive numbers normally include a leading space."
],
"sample": "A$=STR$(42)",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "STRING$",
"keyword": "STRING$",
"title": "STRING$",
"category": "Strings",
"dialect": "common",
"summary": "Create a string containing a repeated character.",
"syntax": [
"STRING$(count,codeOrString)"
],
"parameters": [
"A string argument supplies its first character."
],
"sample": "PRINT STRING$(5,\"*\")",
"exampleID": "formatting",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "SUB",
"keyword": "SUB",
"title": "SUB",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Complete the split spelling GO SUB.",
"syntax": [
"GO SUB line"
],
"parameters": [],
"sample": "GO SUB 100",
"exampleID": null,
"related": [
"GOSUB",
"RETURN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "TAB",
"keyword": "TAB",
"title": "TAB",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Advance within a PRINT line to a column.",
"syntax": [
"PRINT TAB(column);expression"
],
"parameters": [],
"sample": "PRINT TAB(8);\"COCO\"",
"exampleID": null,
"related": [
"PRINT",
"POS"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "TAN",
"keyword": "TAN",
"title": "TAN",
"category": "Math",
"dialect": "common",
"summary": "Return the tangent of an angle in radians.",
"syntax": [
"TAN(angle)"
],
"parameters": [
"Angles near odd multiples of PI/2 produce very large results."
],
"sample": "PRINT TAN(0)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "21"
},
{
"id": "THEN",
"keyword": "THEN",
"title": "THEN",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Introduce the true branch of an IF statement.",
"syntax": [
"IF condition THEN statements"
],
"parameters": [],
"sample": "IF A=1 THEN PRINT \"ONE\"",
"exampleID": null,
"related": [
"IF",
"ELSE"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "TIMER",
"keyword": "TIMER",
"title": "TIMER",
"category": "Timing",
"dialect": "common",
"summary": "Read or set the interpreter's ticking counter.",
"syntax": [
"TIMER",
"TIMER = value"
],
"parameters": [
"The counter wraps at 65536.",
"It advances with the emulated machine, not a guaranteed wall-clock duration."
],
"sample": "TIMER=0:PRINT TIMER",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "17, 22"
},
{
"id": "ERROR.TM",
"keyword": "TM",
"title": "TM — Type mismatch",
"category": "Errors",
"dialect": "common",
"summary": "An expression uses a string where a number is required, or the reverse.",
"syntax": [
"TM ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"VAL",
"STR$",
"INPUT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "TO",
"keyword": "TO",
"title": "TO",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Separate start/end values or source/destination operands.",
"syntax": [
"FOR variable=start TO finish"
],
"parameters": [],
"sample": "FOR I=1 TO 3",
"exampleID": null,
"related": [
"FOR",
"COPY",
"BACKUP"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "TROFF",
"keyword": "TROFF",
"title": "TROFF",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Turn off the BASIC line-number trace.",
"syntax": [
"TROFF"
],
"parameters": [],
"sample": "TROFF",
"exampleID": null,
"related": [
"TRON"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "17"
},
{
"id": "TRON",
"keyword": "TRON",
"title": "TRON",
"category": "Debugging and errors",
"dialect": "common",
"summary": "Show BASIC line numbers as the program executes.",
"syntax": [
"TRON"
],
"parameters": [],
"sample": "TRON",
"exampleID": null,
"related": [
"TROFF"
],
"notes": [
"This is the interpreter's text trace; it is independent of editor breakpoints."
],
"source": "basicGuide",
"sourcePage": "17"
},
{
"id": "ERROR.UL",
"keyword": "UL",
"title": "UL — Undefined line",
"category": "Errors",
"dialect": "common",
"summary": "A branch or run command refers to a line that is not in the program.",
"syntax": [
"UL ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"GOTO",
"GOSUB",
"RUN"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "27"
},
{
"id": "UNLOAD",
"keyword": "UNLOAD",
"title": "UNLOAD",
"category": "Disk files",
"dialect": "disk",
"summary": "Close open files associated with a disk.",
"syntax": [
"UNLOAD [drive]"
],
"parameters": [
"Omitting drive selects the default drive."
],
"sample": "UNLOAD 0",
"exampleID": null,
"related": [
"CLOSE",
"SDC.DRIVE"
],
"notes": [
"This BASIC command does not eject the Mac disk-image file from VCC Plus."
],
"source": "diskGuide",
"sourcePage": "8"
},
{
"id": "USING",
"keyword": "USING",
"title": "USING",
"category": "Keywords and operators",
"dialect": "common",
"summary": "Apply a numeric or string layout to printed values.",
"syntax": [
"PRINT USING \"format\";expression"
],
"parameters": [],
"sample": "PRINT USING \"###.##\";12.5",
"exampleID": "formatting",
"related": [
"PRINT",
"DISK.PRINT"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "Commands and operators"
},
{
"id": "USR",
"keyword": "USR",
"title": "USR",
"category": "Machine language",
"dialect": "common",
"summary": "Call a machine-language function defined with DEF USR.",
"syntax": [
"USRn(argument)"
],
"parameters": [
"n: 0-9. Define a valid entry address and calling convention first."
],
"sample": "A=USR0(42)",
"exampleID": null,
"related": [
"DEF.USR"
],
"notes": [],
"source": "basicGuide",
"sourcePage": "22"
},
{
"id": "VAL",
"keyword": "VAL",
"title": "VAL",
"category": "Strings",
"dialect": "common",
"summary": "Convert a numeric prefix of a string into a number.",
"syntax": [
"VAL(string)"
],
"parameters": [
"Parsing follows BASIC numeric notation."
],
"sample": "PRINT VAL(\"12.5\")",
"exampleID": "strings",
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "22"
},
{
"id": "VARPTR",
"keyword": "VARPTR",
"title": "VARPTR",
"category": "Memory",
"dialect": "common",
"summary": "Find the address of a variable's internal storage.",
"syntax": [
"VARPTR(variable)"
],
"parameters": [
"BASIC may move storage later; do not assume the address remains valid."
],
"sample": "A=42:PRINT VARPTR(A)",
"exampleID": null,
"related": [],
"notes": [],
"source": "basicGuide",
"sourcePage": "22"
},
{
"id": "VERIFY",
"keyword": "VERIFY",
"title": "VERIFY",
"category": "Disk files",
"dialect": "disk",
"summary": "Choose whether disk writes are followed by a verification read.",
"syntax": [
"VERIFY ON",
"VERIFY OFF"
],
"parameters": [
"Verification checks the data written to the emulated disk."
],
"sample": "VERIFY ON",
"exampleID": null,
"related": [
"SAVE"
],
"notes": [
"This is an interpreter setting, not the image's write-protection setting."
],
"source": "diskGuide",
"sourcePage": "8"
},
{
"id": "ERROR.VF",
"keyword": "VF",
"title": "VF — Verification error",
"category": "Errors",
"dialect": "disk",
"summary": "Data read back after a write did not verify. Preserve another copy before continuing to modify the image.",
"syntax": [
"VF ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"VERIFY"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "WIDTH",
"keyword": "WIDTH",
"title": "WIDTH",
"category": "Text and output",
"dialect": "common",
"summary": "Select the CoCo 3 text-screen width.",
"syntax": [
"WIDTH columns"
],
"parameters": [
"columns: 32, 40 or 80.",
"40- and 80-column modes have 24 rows."
],
"sample": "WIDTH 80",
"exampleID": null,
"related": [
"LOCATE",
"ATTR",
"PRINT"
],
"notes": [
"CoCo 3 extension."
],
"source": "basicGuide",
"sourcePage": "17"
},
{
"id": "ERROR.WP",
"keyword": "WP",
"title": "WP — Write protected",
"category": "Errors",
"dialect": "disk",
"summary": "The selected media is read-only. Change protection only if you intend to modify that working copy.",
"syntax": [
"WP ERROR"
],
"parameters": [],
"sample": "",
"exampleID": null,
"related": [
"SAVE",
"SDC.DRIVE"
],
"notes": [],
"source": "diskGuide",
"sourcePage": "9"
},
{
"id": "WRITE",
"keyword": "WRITE",
"title": "WRITE",
"category": "Disk files",
"dialect": "disk",
"summary": "Write comma-delimited data suitable for INPUT.",
"syntax": [
"WRITE #file,expression[,expression ...]"
],
"parameters": [
"String values are quoted automatically."
],
"sample": "WRITE #1,42,\"COCO\"",
"exampleID": null,
"related": [
"OPEN",
"INPUT",
"DISK.INPUT"
],
"notes": [
"Writes to the opened output file."
],
"source": "diskGuide",
"sourcePage": "8"
}
],
"examples": [
{
"id": "hello",
"title": "Hello, CoCo",
"summary": "Print a message and see a string variable.",
"source": "10 CLS\n20 A$=\"HELLO, COCO\"\n30 PRINT A$\n40 END\n",
"expectedOutput": "HELLO, COCO",
"dialect": "common"
},
{
"id": "count",
"title": "A counting loop",
"summary": "Add five values using FOR and NEXT.",
"source": "10 CLS\n20 S=0\n30 FOR I=1 TO 5\n40 S=S+I\n50 NEXT I\n60 IF S=15 THEN PRINT \"COUNT OK\" ELSE PRINT \"FAILED\"\n70 END\n",
"expectedOutput": "COUNT OK",
"dialect": "common"
},
{
"id": "strings",
"title": "Working with strings",
"summary": "Extract and join text without changing its case.",
"source": "10 CLS\n20 A$=\"Color Computer\"\n30 B$=LEFT$(A$,5)+RIGHT$(A$,8)\n40 IF LEN(A$)=14 AND MID$(A$,7,8)=\"Computer\" AND B$=\"ColorComputer\" THEN PRINT \"STRINGS OK\" ELSE PRINT \"FAILED\"\n50 END\n",
"expectedOutput": "STRINGS OK",
"dialect": "common"
},
{
"id": "data",
"title": "Read a small data table",
"summary": "Read mixed numeric and string DATA, then restore its position.",
"source": "10 CLS\n20 READ A,A$\n30 RESTORE\n40 READ B\n50 IF A=12 AND A$=\"COCO\" AND B=12 THEN PRINT \"DATA OK\" ELSE PRINT \"FAILED\"\n60 END\n70 DATA 12,\"COCO\"\n",
"expectedOutput": "DATA OK",
"dialect": "common"
},
{
"id": "arrays",
"title": "Array bounds and elements",
"summary": "Store and retrieve a two-dimensional array element.",
"source": "10 CLS\n20 DIM A(2,3)\n30 A(2,3)=42\n40 IF A(2,3)=42 AND A(0,0)=0 THEN PRINT \"ARRAYS OK\" ELSE PRINT \"FAILED\"\n50 END\n",
"expectedOutput": "ARRAYS OK",
"dialect": "common"
},
{
"id": "branch",
"title": "Choose a branch",
"summary": "Use a computed GOTO to select one of three destinations.",
"source": "10 CLS\n20 A=2\n30 ON A GOTO 100,200,300\n40 PRINT \"FAILED\":END\n100 PRINT \"FAILED\":END\n200 PRINT \"BRANCH OK\":END\n300 PRINT \"FAILED\":END\n",
"expectedOutput": "BRANCH OK",
"dialect": "common"
},
{
"id": "subroutine",
"title": "A returning subroutine",
"summary": "Step into GOSUB, inspect a variable, then Step Out.",
"source": "10 CLS\n20 A=6\n30 GOSUB 100\n40 IF A=36 THEN PRINT \"SUBROUTINE OK\" ELSE PRINT \"FAILED\"\n50 END\n100 A=A*A\n110 RETURN\n",
"expectedOutput": "SUBROUTINE OK",
"dialect": "common"
},
{
"id": "math",
"title": "Numbers and rounding",
"summary": "Compare INT and FIX and evaluate a user-defined function.",
"source": "10 CLS\n20 DEF FNA(X)=X*X\n30 A=INT(-2.7):B=FIX(-2.7)\n40 IF A=-3 AND B=-2 AND FNA(3)=9 AND ABS(-4)=4 AND SQR(16)=4 THEN PRINT \"MATH OK\" ELSE PRINT \"FAILED\"\n50 END\n",
"expectedOutput": "MATH OK",
"dialect": "common"
},
{
"id": "formatting",
"title": "Formatted output",
"summary": "Print a decimal field and a repeated separator.",
"source": "10 CLS\n20 PRINT USING \"###.##\";12.5\n30 PRINT STRING$(8,\"-\")\n40 PRINT \"FORMATTING OK\"\n50 END\n",
"expectedOutput": "FORMATTING OK",
"dialect": "common"
},
{
"id": "error-trap",
"title": "Handle an error",
"summary": "Catch division by zero with ON ERR and check its line number.",
"source": "10 CLS\n20 ON ERR GOTO 100\n30 A=1/0\n40 PRINT \"FAILED\":END\n100 IF ERLIN=30 AND ERNO=10 THEN PRINT \"ERROR TRAP OK\" ELSE PRINT \"FAILED\"\n110 END\n",
"expectedOutput": "ERROR TRAP OK",
"dialect": "common"
},
{
"id": "low-graphics",
"title": "Draw and inspect a point",
"summary": "Draw in a PMODE screen, read the pixel, and return to text.",
"source": "10 CLS\n20 PCLEAR 4\n30 PMODE 4,1:PCLS 0\n40 PSET(20,20,1)\n50 A=PPOINT(20,20)\n60 SCREEN 0,0:CLS\n70 IF A=1 THEN PRINT \"LOW GRAPHICS OK\" ELSE PRINT \"FAILED\"\n80 END\n",
"expectedOutput": "LOW GRAPHICS OK",
"dialect": "common"
},
{
"id": "high-graphics",
"title": "CoCo 3 graphics",
"summary": "Draw a high-resolution pixel and return to 32-column text.",
"source": "10 CLS\n20 HSCREEN 2:HCLS 0\n30 HSET(20,20,3)\n40 A=HPOINT(20,20)\n50 HSCREEN 0:WIDTH 32:CLS\n60 IF A=3 THEN PRINT \"HIGH GRAPHICS OK\" ELSE PRINT \"FAILED\"\n70 END\n",
"expectedOutput": "HIGH GRAPHICS OK",
"dialect": "common"
},
{
"id": "disk-directory",
"title": "List the mounted disk",
"summary": "Read drive zero without modifying its files.",
"source": "10 CLS\n20 DIR 0\n30 PRINT \"DISK DIRECTORY OK\"\n40 END\n",
"expectedOutput": "DISK DIRECTORY OK",
"dialect": "disk"
},
{
"id": "rgb-routing",
"title": "Floppy and hard-disk directories",
"summary": "For the Hard Drive BASIC preset: list FD0, then restore hard-disk routing and list volume zero.",
"source": "10 CLS\n20 DRIVE OFF\n30 DIR 0\n40 DRIVE ON\n50 DIR 0\n60 PRINT \"RGB ROUTING OK\"\n70 END\n",
"expectedOutput": "RGB ROUTING OK",
"dialect": "rgbdos"
},
{
"id": "sdc-mount",
"title": "Browse and mount Hello Disk",
"summary": "For the CoCo SDC starter card: browse the root, mount HELLO.DSK, and list its contents. This changes the current mount but does not write the image.",
"source": "10 CLS\n20 DIR = \"/\"\n30 DIR -\n40 DRIVE 0,\"HELLO.DSK\"\n50 DIR 0\n60 PRINT \"SDC READY\"\n70 END\n",
"expectedOutput": "SDC READY",
"dialect": "sdcdos"
}
]
}