5238 lines
132 KiB
JSON
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"
|
|
}
|
|
]
|
|
}
|