Command: idir

Syntax

idir {<wildname> {,<wildname> ... } }

Description

List the contents of an identifier table.

Parameters

• <wildname>
  The names of identifiers to be listed.

• none
  List the contents of the current (usually local) identifier table.

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.

• -err
  Send the output to the error log.

• -full
  Output the identifier names in full, i.e. with their atable prefix. This is the default behavior. Use -no_full to suppress the atable prefix.

• -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, -of, -os, -ow, -pr or -uof options is used.

• -nam
  Output identifier names without supplementary information. The supplementary information comprises of the identifier type.

• -ocl
  When combined with the -ty=<type> switch, only print type identifier(s) which are of a sub-class of the indicated type.

• -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.

• -sub
  When combined with the -ty=<type> switch, only print identifier(s) if they are of the indicated type, or are of a sub-class of the indicated type.

• -ty=<type>
  Only print the identifier(s) if they are of the indicated identifier type.

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

Notes

Monitor and printer output is preceded by a header line and followed by a summary of the identifiers found. This is omitted when output is directed elsewhere.

Examples

List the current identifier table (local).

idir

List all identifiers in all identifier tables.

idir ~*.*

List all numeric identifiers in mytable (names only). Record the names in a string array.

idir ~mytable.*, -ty=numeric, -nam, -os=nams

See Also