Workspaces

APL expressions are evaluated within a workspace. The workspace may contain objects, namely classes, namespaces, operators, functions and variables defined by the user. APL expressions may include references to primitive operators, functions and variables provided by APL. These objects do not reside in the workspace, but space is required for the actual process of evaluation to accommodate temporary data. During execution, APL records the state of execution through the STATE INDICATOR which is dynamically maintained until the process is complete. Space is also required to identify objects in the workspace in the SYMBOL TABLE. Maintenance of the symbol table is entirely dynamic. It grows and contracts according to the current workspace contents.

Workspaces may be explicitly saved with an identifying name. The workspace may subsequently be loaded, or objects may be selectively copied from a saved workspace into the current workspace.

Under UNIX, workspace names must be valid file names, but are otherwise unrestricted. See your UNIX documentation for details.

Under Windows, Dyalog APL workspaces are stored in files with the suffix ".DWS". However, they are referred to from within APL by only the first part of the file name which must conform to Windows file naming rules.

If the name of the file in which the workspace is saved contains spaces, the ws argument for the system functions )SAVE, )COPY, )PCOPY, )LOAD, )XLOAD and )DROP should be surrounded by two double-quote (") characters. To include a " character in the file name, you must specify two adjoining double-quotes (i.e. """"). Note however that Windows does not allow double-quotes in file names, so this effectively applies only to non-Windows systems.

Examples

      )SAVE Pete's work
unacceptable char

The above statement fails because the presence of the space in the file name requires that it be surrounded by "s.

      )SAVE "Pete's work"
Pete's work.dws saved Sun Jan 17 16:23:17 2016

      )COPY "Pete's work" A B C
.\Pete's work.dws saved Sun Jan 17 16:23:17 2016


      )DROP "Pete's work"
Sun Jan 17 16:24:16 2016