User Commands

User commands are tools that are available at any time, in any workspace, as extensions to the Dyalog development environment.

New user commands are added periodically; see the end of this page for instructions on installing updates. For additional information on user commands, see the User Commands User Guide.

User commands are invoked in an APL Session by starting an input line with a ] character. For example, the ]Boxing user command enables "boxed" output (and can be used to change other details of the way output is formatted):

      ]Boxing on
      'Hello' (1 2 3)
│Hello│1 2 3│

For a summary of the user command syntax, enter ]Help.

For a list of the user commands available in your Session, enter ]?.
For example, with Dyalog version 16.0 (in July 2017):

83 commands:                                                                                                  
 ARRAY         Compare  Edit                                                                                  
 CALC          Factors  FromHex  PivotTable  ToHex                                                            
 EXPERIMENTAL  DBuild  DTest                                                                                  
 FILE          CD  Collect  Compare  Edit  Find  Replace  Split  ToLarge  ToQuadTS  Touch                     
 FN            Align  Calls  Compare  Defs  DInput  Latest  ReorderLocals                                     
 MSWIN         Assemblies  Caption  CopyReg  FileAssociations  GUIProps  KeyPress  Open  ToHTML               
 NS            ScriptUpdate  Summary  Xref                                                                    
 OUTPUT        Box  Boxing  Disp  Display  Find  Format  Layout  Rows                                         
 PERFORMANCE   Profile  RunTime  SpaceNeeded                                                                  
 SALT          Clean  Compare  List  Load  Refresh  RemoveVersions  Save  Settings  Snap                      
 SPICE         UUpdate                                                                                        
 TOOLS         ADoc  Calendar  Chart  Demo  Version                                                           
 TRANSFER      In  Out                                                                                        
 UCMD          UDebug  ULoad  UMonitor  UNew  UReset  USetup                                                  
 WS            Check  Compare  Document  FindRefs  FnsLike  Locate  Map  NamesLike  Nms
               ObsLike  Peek  SizeOf  VarsLike

Updating Your User Commands

Dyalog sometimes makes a new set of user command source files available. To update your user commands:

  1. Download the appropriate .zip file from the table below.
  2. On Microsoft Windows:
    • Extract the contents of the .zip file to a temporary directory.
    • Copy the newly-extracted files to the [DYALOG] installation directory, overwriting any files with the same name that are already present.
      This might need administrator privileges.
  3. On all other operating systems:
    • In a terminal window, with root permissions:
      • Change directory to the [DYALOG] installation directory.
      • Unzip the downloaded .zip file.
  4. In a Dyalog Session, run the ]UReset user command to ensure that no information about the contents of the directories is cached in your APL Session.

NOTE: To identify the [DYALOG] installation directory, enter the following in a Dyalog Session:

      ⎕←2⎕NQ'.' 'GetEnvironment' 'DYALOG'
APL VersionDate of Latest UpdateDownload Links


16.0 2017-08-15

For earlier versions of Dyalog, please contact