plusBASIC Programmer's Reference Old TOC - fvdhoef/aquarius-plus GitHub Wiki

Old table of contents

:warning: denotes functions and statements that require detailed documentation created.

:orange_circle: marks functions and statements that have had stubs created, but requires documentation.

:green_circle: entry migrated to Table of Contents

:x: denotes functions and statements that have not yet been implemented.
PLEASE NOTE THESE HAVE BEEN MOVED TO THE END OF THE LIST

  • :green_circle: ABS() - Return absolute value of expression.
  • AND - Bitwise AND or logical AND operator.
  • :green_circle: APPEND - Append memory or string to a file.
  • ARGS - Get the number of arguments to RUN or GOSUB.
  • ARGS - Pass arguments to RUN or GOSUB.
  • ARGS$() - Get argument string at index.
  • :green_circle: ASC() - Convert string to ASCII code.
  • :green_circle: ASC$() - Convert hex_string to an ASCII string.
  • :green_circle: ATN() - Return arctangent of argument.
  • :warning: BIT - Return status of bit in integer.
  • BYTE() - Convert character in string to signed byte.
  • CALL - Execute machine language routine at address, optionally passing arguments into the associated registers.
  • :green_circle: CD - Change directory, or display current directory.
  • :green_circle: CD$ - Return a string containing the current directory.
  • :green_circle: CHR$() - Convert ASCII value to string.
  • :green_circle: CLEAR - Clear BASIC workspace or array data.
  • :warning: CLEAR BITMAP - Clear bloxel or bitmap screens.
  • :green_circle: CLEAR CURSOR - Temporarily remove cursor from screen.
  • CLOAD and CSAVE - Load, verify or save program or load array data from or to cassette.
  • :orange_circle: CLS - Clear the text screen.
  • COLOR - Set or return default bitmap colors.
  • :green_circle: COMPARE() - Compare numeric arrays or blocks of memory.
  • CONT - Resume program execution after STOP, Ctrl-C/Escape, or error.
  • :green_circle: COPY - Copy text screen to serial printer or memory, or bytes from one block of memory to another.
  • COS() - Return cosine of argument.
  • DATA - Define data for READ statement.
  • :green_circle: DATE$ - Return the current date or date.
  • :green_circle: DATETIME$ - Return the current date and time.
  • :green_circle: DEF ATTRLIST - Create a string list of sprite and/or tile attributes.
  • :warning: DEF FN - Define user-defined function.
  • :green_circle: DEF INTLIST - Create a string list of integers.
  • :green_circle: DEF PALETTELIST - Create a string list of palette numbers.
  • :green_circle: DEF RGBLIST - Create a string list of RGB values.
  • :green_circle: DEF SPRITE - Create a sprite definition.
  • BASIC-DEF-PALETTELIST-Statement**DEF TILELIST** - Create a string list of palatte indexes.
  • :orange_circle: DEF USR and DEF USRINT - Set USR() and user interrupt routine addresses.
  • DIM - Create and allocates one or more arrays.
  • :green_circle: DIR - Display disk directory.
  • END - Terminate program execution.
  • :warning: ERASE - Remove array from memory.
  • :warning: EVAL() - Evaluate expression in string.
  • :green_circle: EXP() - Return argument to the power of mathematical constant e.
  • :green_circle: FILEDIR$() and FILEEXT$() - Extract path or extension from filespec.
  • :warning: FILL BYTE - Fill block of memory with byte.
  • :warning: FILL WORD - Fill block of memory with two-byte integer.
  • :warning: FILL COLORMAP - Fill color map with specified bytes.
  • :warning: FILL SCREEN - Fill screen with character and/or colors.
  • FILL TILEMAP - Fill tilemap with specified tile, attributes and palette.
  • FOR ... TO ... STEP and NEXT - Initiate, iterate, and end a FOR loop.
  • :warning: FRE() - Return amount of unused variable and array or string space (after forcing garage collection).
  • GET SCREEN - Copy text screen to array of string variable.
  • GET TILEMAP - Copy tilemap clip to array or string variable.
  • GETARGS - Parses arguments passed into subroutine.
  • :green_circle: GETKEY and GETKEY$ - Wait for key and return as ASCII code or string.
  • GETPALETTE$ - Return palette content.
  • :orange_circle: GETSPEED - Return turbo mode status.
  • :green_circle: GETSPRITE$ - Return sprite attributes.
  • GETTILE$ - Return tile data.
  • GOSUB and RETURN - Execute subroutine.
  • GOTO - Branch to line or label.
  • HEX$() and DEC() - Convert byte, integer or ASCII string into hexadecimal string or hexadecimal string into integer,
  • IF ... THEN - Branch to line or execute statements if expression evaluates to true.
  • IN() and OUT - Read or write one or more bytes from or to one or more Z80 ports.
  • :warning: INDEX(), INMEM(), and INSTR() - Search for string in array, memory, or string.
  • :green_circle: INKEY and INKEY$ - Return most recently pressed key as integer or string.
  • INPUT - Prompt for keyboard input and assigns entries to variables.
  • :green_circle: INT() - Return expression rounded down to nearest integer.
  • :warning: JOIN - Join strings into a string array.
  • :green_circle: JOY() - Read one or both game controllers.
  • :green_circle: JOY$() - Read X-box controller.
  • KEY() - Check if key is currently pressed.
  • :green_circle: LEFT$() - Return or replace substring.
  • :green_circle: LEN() - Return length of string.
  • LET - Define and assigns value to variable.
  • LIST - Print program lines to screen.
  • :orange_circle: LIST$() - Detokenize program line.
  • :orange_circle: LLIST - Print program lines to printer.
  • LOAD - Load BASIC program, binary file, or array data into memory.
  • :green_circle: LOAD BITMAP - Loads bitmap file into Video RAM.
  • :warning: LOAD CHRSET - Load character RAM from file.
  • :warning: LOAD DIR - Load disk directory into string array.
  • LOAD FNKEYS - Load function key definitions from file.
  • LOAD PALETTE - Load file data ino palette.
  • :warning: LOAD TRACK - Load tracker file into PT player buffer.
  • :warning: LOAD SCREEN - Load text screen, character matrix, or color matrix from file.
  • :warning: LOAD TILEMAP - Loads timemap file into RAM.
  • :green_circle: LOCATE - Move text cursor to specified position.
  • :green_circle: LOG() - Return natural logarithm of argument.
  • :warning: LOOP TRACK - Play specified or previously loaded track repeatedly.
  • :warning: LPOS - Return current column position of printer.
  • :green_circle: MID$() - Return or replace substring.
  • :warning: MKDIR - Create directory.
  • MOUSEX, MOUSEY, MOUSEB, and MOUSEW - Return mouse x-position, y-position, button status, and wheel delta.
  • NEW - Delete program and clears all variables.
  • NEXT - Iterate the next increment for the matching FOR statement.
  • NOT - Bitwise NOT or logical NOT operator.
  • ON GOSUB, ON GOTO, and ON ERROR - Branch to line or subroutine specified by expression or error condition.
  • OR - Bitwise OR or logical OR operator.
  • PAD$() - Return padded string.
  • PAUSE - Halt program execution until key is pressed.
  • :warning: PAUSE TRACK - Pause currently playing track.
  • PEEK(), PEEK$(), and DEEK() - Read byte, string, or word from memory.
  • :orange_circle: PEEKSCREEN(), PEEKSCREEN$(), PEEKCOLOR(), and PEEKCOLOR$() - Read byte or string from screen or color RAM.
  • PLAY TRACK - Play music track.
  • PLAY SAMPLE - Play digitized sound.
  • POKE and DOKE - Write byte, integer, or string to memory.
  • POKE COLOR - Write byte or string to color RAM.
  • POKE SCREEN - Write byte or string to screen RAM.
  • :green_circle: POS() - Return current cursor column.
  • :orange_circle: POSX and POSY - Return last draw position.
  • PSET, PRESET, and POINT - Draw, erase, or return status of bloxel or pixel.
  • PRINT and LPRINT - Print text to screen or printer.
  • :warning: PSG - Write bytes to PSG register
  • :warning: TRACKFAST, TRACKLOOP and TRACKSTATUS - Return track player loop flag and play/pause status.
  • PUT SCREEN - Copy clip from array or string variable to text screen.
  • PUT TILEMAP - Copy clip from array or string variable to tilemap.
  • READ - Read values from data statements into variables.
  • REM - Denotes comment.
  • :warning: RENAME - Rename file or directory
  • :warning: RESET - Set all array elements to 0 or empty string and collect garbage if string array.
  • :warning: RESET PALETTE - Reset palette to default RGB values.
  • :warning: RESET SCREEN - Reset current text screen to default settings.
  • RESTORE - Reset READ/DATA pointer to beginning of program or specified line.
  • RESUME - Clear error condition and continues program execution at specified line
  • RESUME TRACK - Resume playing paused track.
  • :green_circle: RGB() and RGB$() - Return integer or string representing a single palette entry.
  • RIGHT$() - Return or replace substring.
  • :green_circle: RND() - Return new or previous psuedo-random number or seeds the random number generator.
  • RUN - Execute current basic program or load and execute program, cartridge image, or FPGA core.
  • :green_circle: SAVE - Write BASIC program, memory, or array data to file.
  • :green_circle: SAVE BITMAP - Save bitmap screen data from Video RAM to file.
  • :warning: SAVE FNKEYS filespec - Save function key definitions to file.
  • SAVE PALETTE - Save palette contents to file.
  • SAVE SCREEN - Save text screen to file.
  • :warning: SAVE TILEMAP - Save tilemap to file.
  • SCREEN - Set screen mode.
  • :warning: SET CHRDEF and GETCHRDEF() - Redifine character or get character definition.
  • :green_circle: SET COLOR - Enable or disable color printing mode
  • SET FNKEY - Set auto-typed text when function key is pressed.
  • SET KEY - Set alternate keyboard port mode.
  • :green_circle: SET PALETTE - Set palette entries.
  • :warning: SET TRACK - Set track player options.
  • SET SAVE - Enable or disable forced saving of BASIC programs in ASCII format.
  • :orange_circle: SET SPEED and SET FAST - Enable or disables turbo mode.
  • :green_circle: SET SPRITE - Set sprite properties.
  • SET TILE - Write tile definition video RAM.
  • SET TILEMAP and SET TILEMAP OFFSET - Set tilemap cell attributes or scroll tilemap.
  • :orange_circle: SET USRINT -Enable or disable and user interrupt routine addresses.
  • :green_circle: SGN() - Return signum of expression.
  • :green_circle: SIN() - Return sine of argument.
  • :warning: SOUND () - Generate a tone through the television speaker.
  • SPC() - Output a number of space characters.
  • :warning: SPLIT - Split delimited string into string array elements..
  • :green_circle: SQR() - Return square root of argument.
  • :warning: STASH SCREEN, RESTORE SCREEN, and SWAP SCREEN - Copy current text screen to or from or swap with respective screen buffer.
  • STOP - Interrupt program execution.
  • :warning: STOP TRACK - Stop currently playing track.
  • :green_circle: STR$() - Convert floating point number to ASCII string.
  • :green_circle: STRING$() - Create string of repeated character.
  • :warning: STRPTR() - Return address of text for string variable.
  • :warning: SWAP VARS - Swap contents of two variables.
  • TAB() - Moves cursor to a relative position on screen.
  • :green_circle: TAN() - Return tangent of argument in radians.
  • :orange_circle: TILEMAP(), TILEMAPX TILEMAPY, TILEOFFSET, and TILEOFFSET - Return tilemap cell properties, X-offset or Y-offset of tilemap, or first available tile.
  • :green_circle: TIME$ - Return the current time.
  • TIMER - Set and start jiffy timer or return timer count.
  • :green_circle: TRIM$(), TRIML$(), and TRIMR$() - Remove characters from left, right, or both ends of string.
  • :green_circle: TRIMDIR$() and TRIMEXT$() - Remove path or extension from filespec.
  • :warning: TRON and TROFF - Enable or disable line number tracing.
  • USE CHRSET, GETCHRSET, LOAD CHRSET, and SAVE CHRSET - Load character, acivate and query current character set.
  • USR() - Call user-defined machine language routine passing argument and returning result.
  • :green_circle: VAL() - Convert ASCII string to floating point number.
  • :warning: VARPTR() - Return address of variable, array element, or array
  • :warning: VER() and VER$() - Return System or plusBASIC version as integer or printable string.

  • :x: CIRCLE - Not implemented
  • :x: CLOSE - Not implemented
  • :x: DEF USR - Not implemented
  • :x: EDIT - Not implemented
  • :x: FILL BITMAP - Syntax changing soon
  • :x: LINE - Not implemented
  • :x: LINEH - Not implemented
  • :x: LINEV - Not implemented
  • :x: MENU - Not implemented
  • :x: OPEN - Not implemented
  • :x: RESTORE BITMAP|TILEMAP|PALETTE palette{,...} - Not implemented
  • :x: STASH BITMAP|TILEMAP|PALETTE palette{,...} - Not implemented
  • :x: SWAP BITMAP|TILEMAP - Not implemented
  • :x: WRITE - Not implemented