prev Command

Moves current position to previous object (line, level, class or word).

Scope: View

Syntax

Parameters

visible 
Restrict moves to objects that are currently visible. (See the include and exclude parameters on making lines visible in the current view.) If visible is not specified and the Editor sets the current position on an object that is not visible, the current position is subsequently adjusted to a visible line unless the showcurrent parameter is set to on. If used, this must be the first parameter specified.
element 
Moves to the previous structural line. This is the default value.
above 
Moves to the previous line at a higher level. If none is found, the current position remains unchanged.
below 
Moves to the previous line at a level below that of the current line. If none is found, the current position moves to the previous structural line at a higher level.
class ClassName 
Moves to the previous line of the specified ClassName.
level Level 
Moves to the previous line at the specified level.
same 
Moves to the previous line at the same level (or above) or, if none is found, to the previous line at a lower level.
word 
Moves to the start of the previous word.

Description

The prev command moves the current position to the previous element, level, class or word, depending on which parameter is specified.

The same, above, and below command parameters operate within the local display group (displayed text in a view). Any line at the relevant level that has structural information, that is, formatting flags before, after, or absolute is considered structural. Any line at level zero is also considered structural.

The class, level, and word command parameters operate without regard to display groups.

Example

To move the current position to the previous visible class COMMENT, type:

prev visible class comment 

API Return Code

-1 
The ClassName was not a valid class type. Use the query classes command to see which ClassNames are currently defined, or use the set class command to define a new class. Issue the command again using a valid ClassName.

next Command