repeat Command

Repeats a command a specified number of times.

Scope: Global

Syntax

Parameters

Number 
The number of times the command is to be repeated. It is a non-zero positive integer.
Command 
The command sequence to be repeated. The mult command can be used as the Command to be performed.

Description

The repeat command runs any Editor command repeatedly until either the given number of runs is complete, or an API return code occurs.

Note: The command is processed by the lxi command, so you can use synonyms of the command and its parameters.

Example

To repeat the command next class comment five times or until a nonzero return code occurs, type:

repeat 5 next class comment 

The current position moves to the fifth COMMENT type line.

API Return Code

-1 
A parameter issued with the command was not valid. Check the command syntax requirements and then issue the command again using a valid parameter.

Return codes are also issued by the repeated command.


lxi Command