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