BASIC Filesystem Statements and Functions - fvdhoef/aquarius-plus GitHub Wiki

BASIC Filesystem Statements and Functions

CD

TYPE: USB BASIC filesystem statement

FORMAT: CD

Action: Displays the current directory path.

Examples: 
CD

Immediately after boot up prints the string "/"

FORMAT: CD path-spec

Action: Changes the current directory to the specified directory path.

  • path-spec specifies the directory to change to.
  • Prints "Ok" upon successful current directory change.
  • No disk error results if SD card is not present.
  • File not found error if the specified directory does not exist
Examples: 
CD "/"

Changes current directory to root directory of the SD Card.

CD "/roms"

Changes current directory to /roms/ directory of the SD Card.

CD "/roms/"

Changes current directory to /roms/ directory of the SD Card.

CD "."

Changes current directory to the current directory. Essentially does nothing.

CD ".."

Changes current directory to parent directory of the current directory.

CD$

TYPE: plusBASIC filesystem function

FORMAT: CD$

Action: Returns a string containing the current directory path.

Examples: 
CD /roms
D$=CD$
PRINT D$

Prints /roms

DEL

TYPE: USB BASIC filesystem statement

FORMAT: DEL path_spec

Action: Delete file or directory.

  • path-spec specifies the file or directory to delete.
  • ??? error occurs if file or directory does not exist.
  • ??? error occurs if a directory that is not empty is specified.

DIR

TYPE: USB BASIC filesystem statement

FORMAT: DIR

Action: Displays a listing of the current directory.

⚠️ File not found error will result if the SD Card is not present. ⚠️

FORMAT: DIR path-spec

Action: Displays a listing of the contents of the specified directory.

  • path-spec specifies directory to list the contents of.
  • File not found error results if the specified directory does not exist.

MKDIR

TYPE: USB BASIC filesystem statement

FORMAT: NKDIR path_spec

Action: Creates a directory.

  • path-spec specifies directory to create.
  • *details here

Path-String

A path-string is a string expression containing a path and/or filename.

  • details here
Examples:

No examples yet

Path-Spec

A path-spec specifies a path and/or file name.

  • A path_spec normally consists of a string expression.
  • In immediate mode only, a path_spec may be an unquoted literal string, subject to the following rules:
    • The string may not contain spaces or a colon.
      • To specify file/path names that contain these characters, enclose the name in quotes.
    • This option is only available for file-system commands that take a single file/path as an argument.
Examples:

No examples yet

⚠️ **GitHub.com Fallback** ⚠️