all Command

Shows all lines or only those selected by a command.

Scope: View

Syntax

Parameter

Command 
Any valid Editor command, including required and optional parameters.

Description

If a command is not provided, all lines are displayed.

If a command is provided, only selected lines in the current file are displayed. Selection occurs as follows, starting with the first line in the current file:

  1. The command is applied against the contents of the current line.
  2. If the current line does not change as a result of running the command, that line is added to the displayed lines, and processing moves to the next line in the file.
  3. If running the command causes the current line to change, the new current line is displayed, and processing continues with the line following the new current line.
  4. Processing stops when the end of the file is reached.

Depending on the command specified, the contents of the file may or may not change. Using commands such as add or delete will result in changes to the file.

Using other commands, such as the find command, may result in only a subset of lines in the file being displayed, but will not change the original contents of the file. For example, issuing the command:

all find asis a_non-existent_word 

results in no lines being displayed. All lines of the file can be redisplayed by issuing the all command without specifying a command.

Examples

  1. To display only those lines containing string, type:
    all find any string 
  2. To display all lines, type:
    all

API Return Code

-3 
Specify less than 29 ClassNames. The all command occupies one class name, so you must specify less than 29 class names although the maximum number of class names is 30.

exclude Parameter
include Parameter