Reference Guide

Full Command and Function Reference 3-155
See also: ABS, CONJ, NOT, SIGN
NEWOB
Type: Command
Description: New Object Command: Creates a new copy of the specified object.
NEWOB has two main uses:
• NEWOB enables the purging of a library or backup object that has been recalled from a port.
NEWOB creates a new, separate copy of the object in memory, thereby allowing the original
copy to be purged.
• Creating a new copy of an object that originated in a larger composite object (such as a list)
allows you to recover the memory associated with the larger object when that larger object is no
longer needed.
Access: !° MEMORY NEWOB ( °is the left-shift of the Nkey).
Flags: Last Arguments (–55). In order for NEWOB to immediately release the memory occupied by the
original copy, flag –55 must be set so that the copy is not saved as a last argument.
Input/Output:
Level 1/Argument 1 Level 1/Item 1
obj
→
obj
Example 1: :0:BKUP1 RCL NEWOB :0:BKUP1 PURGE recalls and purges the backup object
BKUP1.
Example 2: 3 GET NEWOB retrieves the third element out of a list on the stack, recovering the memory
occupied by the whole list.
See also: MEM, PURGE
NEXT
Type: Command
Description: NEXT Command: Ends definite loop structures.
See the FOR and START keyword entries for more information.
Access: !° BRANCH START / FOR NEXT ( °is the left-shift of the Nkey).
Input/Output: None
See also: FOR, START, STEP
NEXT
Type: Operation
Description: NEXT Operation: Returns but does not execute the next one or two steps of a program.
Access: „°LL RUN NEXT ( °is the left-shift of the Nkey).
Input/Output: None
See also: SST, SST↓
NEXTPRIME
Type: Function
Description: Given an integer, returns the next prime number larger than the integer. Like ISPRIME?, it uses a
pseudoprime check for large numbers.
Access: Arithmetic, !Þ INTEGER L
Input: An integer or an expression that evaluates to an integer.
Output: The next prime number larger than the integer.
Example: Find the closest, larger prime number to 145.