Command: dir

Syntax

dir {<wildname> {,<wildname> ... } }

Description

List the contents of a directory.

Parameters

• <wildname>
  The directories or files to be listed. The omission of parameters will list the contents of the current working directory.

Switches

• -a
  Combined with the -of switch, use append mode to add to an existing text file.

• -c
  Combined with the -of switch, if <file> exists, prompt for confirmation before it is replaced.

• -ch=<channel>
  Send the output to a channel currently open for output.

• -dir
  Only include directories in the output. Simple files are omitted.

• -err
  Send the output to the error log.

• -fu
  Output file names in full including their directory path. If omitted, the directory parts of file names are discarded.

• -log=<panel>
  Send the output to a log sub-panel.

• -m
  Send the output to the monitor. This is the default behavior unless one of the -ch, -err, -log, -of, -os, -ow, -pr or -uof options is used.

• -no_dir
  Only include simple files in the output. Directories are omitted.

• -of=<file>
  Send the output to a text file.

• -os=<ident>
  Send the output to a string identifier. If the identifier does not exist, a new string array is created using current scope rules.

• -ow=<window>
  Send the output to an alpha window.

• -pau
  When listing to the monitor window, pause on each page full.

• -pr
  Send the output to the printer.

• -uof=<string>
  Send the output to a Unix filter process.

Notes

Monitor, error log, panel log and printer output is preceded by a header line and followed by a count of the files found. These are omitted when output is directed elsewhere.

The number of files found during this operation is recorded automatically in the numeric system identifier found.

Directory operations on files within compiled applications, e.g. dir @test/*.cmd, are currently not implemented.

Examples

List the contents of the current directory.

dir

List all .cmd and .dat files.

dir *.cmd,*.dat

List .dat files to a string array dd.

dir *.dat,-os=dd

Send a listing to a new alpha window.

dir -ow=new_window

See Also