{ "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" } ] }