IVI: Cursor Positioning

IVI

Cursor Positioning Commands

Command: POsition

Purpose: Move the cursor to an absolute position in the corefile.

Format: PO <number>|<number>

Parameters:The two numbers represent (absolute) line and column numbers for the new cursor position. If either is omitted, the default is the current line or column.

A negative line number specifies the number of lines from the end of the file; a negative column number, the number of columns from the last non-blank.

The symbol * may be used in place of the line number, in which case the destination line is that of the first star (block flag) in the corefile.

If the command changes the cursor line, the new cursor line moves to the top of the display window.

The command may be used for records, but the column number becomes a character count in the representation of the record, and is not particularly meaningful.

Examples:

PO 10|25 - move cursor to line 10, column 25 of the corefile.
PO 10 - move cursor to line 10 (leaving column unaltered).
PO 17|-1 - move the cursor to last character on line 17.
PO -20 - move cursor 20 lines from the end of the corefile, and so display the last 20 lines.
PO * - move the cursor to the first line of the flagged block.


Command: ADvance

Purpose: Move the cursor to relative position in the corefile.

Format: AD <number>|<number>

Parameters:The two numbers represent the new line and column numbers relative to the current cursor position, that is to say, the number of lines and columns by which the cursor must be moved to get to the new position.

Negative parameters cause the cursor to move backwards. If either is omitted, the default is zero, so cursor stays in the current line or column.

If the command changes the cursor line, the new cursor line moves to the top of the display window.

Examples:

AD 10 - move the cursor 10 lines forward.
AD 17|25 - advance the cursor 17 lines and 25 columns forward.
AD -5 - move the cursor 5 lines backwards.
AD |-10 - move the cursor 10 columns backwards.


Command: BEgin

Purpose: Move the cursor to the start of the corefile.

Format: BE

In effect, the same as PO 1|1.


Command: ENd

Purpose: Move the cursor to the top left corner of last screenful of the corefile.

Format: EN

In effect, PO -n|1, where n is the number of lines in the text zone.


Return to IVI Reference Manual


Last revision: January 17, 2002.