contents.gifprev1.gifnext1.gif

MOVE_VERTICAL

Description:

MOVE_VERTICAL moves by the number of lines passed as its parameter and tries to keep the same character offset as it moves. If tabs or control characters are on the screen, the column the cursor is located in may change. To change this default behavior, use the SET(COLUMN_MOVE_VERTICAL, ON) built-in. Moving past the beginning or end of the buffer causes nu/TPU to display a warning message.

Syntax:

MOVE_VERTICAL (integer)

Example:

The following commands move the current position one half window at a time by utilizing the CURRENT_WINDOW and GET_INFO built-ins.

MOVE_VERTICAL (GET_INFO (CURRENT_WINDOW, "visible_length")/2);

Errors:

TPU$_BEGOFBUF Already at buffer's beginning.

TPU$_ENDOFBUF Already at buffer's end.

TPU$_NOCURRENTBUF Not in a buffer.

Related Builtins:

SET(COLUMN_MOVE_VERTICAL)