Purge; Push; Put - HP 48gII Advanced User's Reference Manual

PURGE

Type: Command
Description: Purge Command: Purges the named variables or empty subdirectories from the current directory.
PURGE executed in a program does not save its argument for recovery by LASTARG.
To empty a named directory before purging it, use PGDIR.
To help prepare a list of variables for purging, use VARS.
Purging PICT replaces the current graphics object with a 0 × 0 graphics object.
If a list of objects (with global names, backup objects, library objects, or PICT) for purging
contains an invalid object, then the objects preceding the invalid object are purged, and the error
Bad Argument Type occurs.
To purge a library or backup object, tag the library number or backup name with the appropriate
port number (:n
number can be replaced with the wildcard character &, in which case the hp49g+/hp48gII will
search ports 0 through 2, and then main memory for the named backup object.
A library object must be detached before it can be purged from the HOME directory.
Neither a library object nor a backup object can be purged if it is currently "referenced"
internally by stack pointers (such as an object on the stack, in a local variable, on the LAST stack,
or on an internal return stack). This produces the error Object in Use. To avoid these
restrictions, use NEWOB before purging. (See NEWOB.)
!°
Access:
I
PURGE
Input/Output:
See also: CLEAR, CLVAR, NEWOB, PGDIR

PUSH

Type: Command
Description: Saves the current status of the flags, and the current directory path. This allows the user to
change the flags or the directory path, then restore them all with the command POP. PUSH is
equivalent to saving the results of the commands RCLF and PATH, but it saves them in a stack
from which the most recently saved values are recovered by POP, with no need to use named
variables. The flags and the path are stored in the CASDIR directory, as a list of lists, in the
variable ENVSTACK.
...µ
Access:
Input: None.
Output: Item 1: In Algebraic mode the command returns NOVAL.
See also: POP

PUT

Type: Command
), which must be in the range from 0 to 3. For a backup object, the port
port
MEMORY PURGE
Level 1/Argument 1
'global'
{ global ... global
1
PICT
:n :name
port backup
:n :n
port library
PUSH
( °is the left-shift of the Nkey).
}
n
Full Command and Function Reference 3-131
Level 1/Item 1