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. |
![]()
