System command: Difference between revisions
Jump to navigation
Jump to search
m (Text replacement - "</source>" to "</syntaxhighlight>") |
m (Text replacement - "ISO/IEC 13751:2001" to "ISO/IEC 13751:2001") |
||
(One intermediate revision by one other user not shown) | |||
Line 1: | Line 1: | ||
'''System commands''' provide services or information associated with the workspace and the environment. They are not part of the APL language itself. | '''System commands''' provide services or information associated with the workspace and the environment. They are not part of the APL language itself. | ||
APL system commands start with a right parenthesis, e.g., < | APL system commands start with a right parenthesis, e.g., <syntaxhighlight lang=apl inline>)save</syntaxhighlight>, <syntaxhighlight lang=apl inline>)pcopy</syntaxhighlight>. | ||
== List of system commands == | == List of system commands == | ||
=== ISO/IEC 13751:2001 === | === ISO/IEC 13751:2001 === | ||
[[ | [[ISO/IEC 13751:2001]] standard defined the following system commands:<ref>BS ISO/IEC 13751:2001: Information technology. Programming languages, their environments and system software interfaces. Programming language Extended APL. (2001).</ref> | ||
{|class="wikitable" | {|class="wikitable" | ||
! Command !! Description | ! Command !! Description | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)CLEAR</syntaxhighlight> || Clear active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)COPY</syntaxhighlight> || Copy library workspace / Copy library workspace object. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)DROP</syntaxhighlight> || Drop library workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)ERASE</syntaxhighlight> || Erase global referent. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)FNS</syntaxhighlight> || Lists global function names. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)LIB</syntaxhighlight> || List library directory. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)LOAD</syntaxhighlight> || Load library workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)NMS</syntaxhighlight> || List global names and their name class. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)OPS</syntaxhighlight> || List global operator names. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)SAVE</syntaxhighlight> || Save active workspace / Save active workspace with name. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)SI</syntaxhighlight> || List state indicator. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)SIC</syntaxhighlight> || Clear state indicator. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)SINL</syntaxhighlight> || List state indicator and local names. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)VARS</syntaxhighlight> || List global variable names. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)WSID</syntaxhighlight> || List workspace identification / Change workspace identification. | ||
|} | |} | ||
Line 46: | Line 46: | ||
! Command !! Description | ! Command !! Description | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)classes</syntaxhighlight> || Lists the APL classes in the active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)clear</syntaxhighlight> || Clear the workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)cmd {Y}</syntaxhighlight> || Executes an operating system command; equivalent to <syntaxhighlight lang=apl inline>)sh</syntaxhighlight>. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)continue</syntaxhighlight> || Saves the active workspace as Continue and terminate APL. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)copy {Y}</syntaxhighlight> || Copies all or selected objects from a saved workspace into the active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)cs {Y}</syntaxhighlight> || Change current namespace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)drop {Y}</syntaxhighlight> || Deletes a named workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)ed Y</syntaxhighlight> || Opens an object in the editor. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)erase Y</syntaxhighlight> || Deletes objects from the active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)events</syntaxhighlight> || Lists the events that the current GUI namespace may generate. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)fns {Y}</syntaxhighlight> || Lists global functions in the active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)holds</syntaxhighlight> || Lists the tokens acquired or requested by :Hold. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)interfaces</syntaxhighlight> || List the currently active interfaces. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)lib {Y}</syntaxhighlight> || Lists all available workspaces or workspaces in a directory Y. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)load {Y}</syntaxhighlight> || Replace the active workspace by a saved workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)methods</syntaxhighlight> || List methods in GUI namespace or object. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)ns {Y}</syntaxhighlight> || Create a global namespace / Query the name of the current namespace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)obs {Y}</syntaxhighlight> || List the global namespaces in the active workspace. Synonym: <syntaxhighlight lang=apl inline>)objects {Y}</syntaxhighlight>. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)off</syntaxhighlight> || Terminate APL immediately. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)ops {Y}</syntaxhighlight> || Lists global operators in the active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)pcopy {Y}</syntaxhighlight> || Protected copy. Similar to <syntaxhighlight lang=apl inline>)copy</syntaxhighlight>, but does not overwrite existing objects. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)props</syntaxhighlight> || List properties of GUI namespace or object. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)reset</syntaxhighlight> || Clears the execution stack (Reset the state indicator). | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)save {Y}</syntaxhighlight> || Saves the active workspace to disk. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)sh {Y}</syntaxhighlight> || Executes an operating system command; equivalent to <syntaxhighlight lang=apl inline>)cmd</syntaxhighlight>. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)si</syntaxhighlight> || State Indicator. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)sic</syntaxhighlight> || Clear State Indicator. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)sinl</syntaxhighlight> || State Indicator with local Name List. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)tid {Y}</syntaxhighlight> || Switches to suspended thread, or lists the current thread number. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)vars {Y}</syntaxhighlight> || Lists global variables in the active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)wsid {Y}</syntaxhighlight> || Query / Set the identity of the active workspace. | ||
|- | |- | ||
| < | | <syntaxhighlight lang=apl inline>)xload Y</syntaxhighlight> || Load a workspace without executing its Latent Expression (<syntaxhighlight lang=apl inline>⎕LX</syntaxhighlight>). | ||
|} | |} | ||
Latest revision as of 00:24, 10 March 2024
System commands provide services or information associated with the workspace and the environment. They are not part of the APL language itself.
APL system commands start with a right parenthesis, e.g., )save
, )pcopy
.
List of system commands
ISO/IEC 13751:2001
ISO/IEC 13751:2001 standard defined the following system commands:[1]
Command | Description |
---|---|
)CLEAR |
Clear active workspace. |
)COPY |
Copy library workspace / Copy library workspace object. |
)DROP |
Drop library workspace. |
)ERASE |
Erase global referent. |
)FNS |
Lists global function names. |
)LIB |
List library directory. |
)LOAD |
Load library workspace. |
)NMS |
List global names and their name class. |
)OPS |
List global operator names. |
)SAVE |
Save active workspace / Save active workspace with name. |
)SI |
List state indicator. |
)SIC |
Clear state indicator. |
)SINL |
List state indicator and local names. |
)VARS |
List global variable names. |
)WSID |
List workspace identification / Change workspace identification. |
Dyalog APL
Dyalog APL supports the following system commands:
Command | Description |
---|---|
)classes |
Lists the APL classes in the active workspace. |
)clear |
Clear the workspace. |
)cmd {Y} |
Executes an operating system command; equivalent to )sh .
|
)continue |
Saves the active workspace as Continue and terminate APL. |
)copy {Y} |
Copies all or selected objects from a saved workspace into the active workspace. |
)cs {Y} |
Change current namespace. |
)drop {Y} |
Deletes a named workspace. |
)ed Y |
Opens an object in the editor. |
)erase Y |
Deletes objects from the active workspace. |
)events |
Lists the events that the current GUI namespace may generate. |
)fns {Y} |
Lists global functions in the active workspace. |
)holds |
Lists the tokens acquired or requested by :Hold. |
)interfaces |
List the currently active interfaces. |
)lib {Y} |
Lists all available workspaces or workspaces in a directory Y. |
)load {Y} |
Replace the active workspace by a saved workspace. |
)methods |
List methods in GUI namespace or object. |
)ns {Y} |
Create a global namespace / Query the name of the current namespace. |
)obs {Y} |
List the global namespaces in the active workspace. Synonym: )objects {Y} .
|
)off |
Terminate APL immediately. |
)ops {Y} |
Lists global operators in the active workspace. |
)pcopy {Y} |
Protected copy. Similar to )copy , but does not overwrite existing objects.
|
)props |
List properties of GUI namespace or object. |
)reset |
Clears the execution stack (Reset the state indicator). |
)save {Y} |
Saves the active workspace to disk. |
)sh {Y} |
Executes an operating system command; equivalent to )cmd .
|
)si |
State Indicator. |
)sic |
Clear State Indicator. |
)sinl |
State Indicator with local Name List. |
)tid {Y} |
Switches to suspended thread, or lists the current thread number. |
)vars {Y} |
Lists global variables in the active workspace. |
)wsid {Y} |
Query / Set the identity of the active workspace. |
)xload Y |
Load a workspace without executing its Latent Expression (⎕LX ).
|
External links
Tutorials
- Bernard Legrand. Mastering Dyalog APL (page 805). Dyalog Ltd. November 2009.
Documentation
References
- ↑ BS ISO/IEC 13751:2001: Information technology. Programming languages, their environments and system software interfaces. Programming language Extended APL. (2001).