manual:chapter4:dirs

This is an old revision of the document!


Directories are so-called 'pseudo-objects' that are simply containers for storing any other type of object (a variable, list, or another directory). One can think of them as forming a filesystem like on any computer. The root directory is defined to be HOME, which is the current directory when the newRPL system is initially booted. Creating and deleting directories (known as subdirectories) within HOME is accomplished with the CRDIR (create directory) and PGDIR (purge directory) commands.

As an example, this creates the subdirectory TEST from the current working directory:

'TEST' CRDIR

The directory name is enclosed in single quotes (as opposed to strings that use double-quotes as delimiters). Now the TEST subdirectory shows up as an object in the soft menus. Selecting it enters that directory, and the current directory path is displayed in the status area. To move back up to the parent directory, use the command UPDIR. Anywhere in the directory tree executing HOME will return the user to the root or HOME directory. To delete a directory, use the command PGDIR. Note that this command will delete the directory and all subdirectories, so use it carefully, especially if there are variables stored in the directory as currently there is no confirmation for purging non-empty directories.

Storing objects, or variables, within a directory is accomplished with the STO and RCL commands.

For example:

42 'Mynum' STO

will store the number 42 into the named variable 'Mynum', and to recall this newly created variable to the stack either press the corresponding soft menu key or,

'Mynum' RCL

There are two other ways to quickly store/recall variables:

1. Use the dedicated store and recall keys, which are now mapped to the HIST and LS-HIST keys, respectively. So, to store the number 42 as above, put 42 and 'Mynum' on the first two levels of the stack and press HIST. To recall the number, simply put 'Mynum' on the stack and press LS-HIST.

2. Use the shortcut keys for moving variable contents into and out of soft menu key assignments: RS-Menukey recalls the variable to the stack, and LS-Menukey stores the contents of stack level 1 to the soft Menukey.

  • manual/chapter4/dirs.1494382152.txt.gz
  • Last modified: 2017/05/09 19:09
  • by smartin