CONTENTS | INDEX | PREV | NEXT

SYNTAX            : ARG V REGLIST TERM
                    (argument: 7.0)

RESULTING ARGUMENT: None

FUNCTION          : Save the content of a number of registers. The value,
                    whether numerical or textual, of each register specified
                    is pushed onto its stack. The register is then cleared
                    to (numeric) 0.

                    The list of registers immediately follows the command,
                    and is terminated by an ESC or (6.3b) a RETURN.

                    The counterpart for Push register is Pop register.

7.0
ARGUMENT          : The number of stack entries to create.

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
                    pushed (not even if the start of the list is correct).
                    A duplicate register or invalid register error will then
                    be reported.

MATRIX