CONTENTS | INDEX | PREV | NEXT
SYNTAX : ARG ^ REGLIST TERM
(argument: 7.0)
RESULTING ARGUMENT: None
FUNCTION : Restore the content of a number of registers. The value,
whether numerical or textual, of each register specified
is popped from its stack. The previous content is lost.
The list of registers immediately follows the command,
and is terminated by an ESC or (6.3b) a RETURN.
The counterpart for Pop register is Push register.
7.0
ARGUMENT : The number of stack entries to remove.
7.0
DEFAULT : 1
EXAMPLE : v01 ESC .u0 < :s test ESC ; %1 > q1= q0j ^01 ESC
This command saves the values of registers 0 and 1,
uses them to store current cursor position (0) and
count occurrences of string test (1), displays
the count, restores the cursor position, and retrieves
the original content of registers 0 and 1.
NOTE : If the register-list is incorrect, no registers are
popped (not even if the start of the list is correct).
A duplicate register, invalid register or empty stack
error will then be reported.
MATRIX