Doerr; Dolist - HP 48gII Advanced User's Reference Manual

DOERR

Type: Command
Description: Do Error Command: Executes a "user-specified" error, causing a program to behave exactly as if
a normal error had occurred during program execution.
DOERR causes a program to behave exactly as if a normal error has occurred during program
execution. The error message depends on the argument provided to DOERR:
• n or #n
error
• "error" displays the contents of the string. (A subsequent execution of ERRM returns "error".
ERRN returns # 70000h.)
• 0 abandons program execution with an 'interrupted' error message (ERRN = #13Fh).
• 0 DOERR is equivalent to pressing −.
!°LL
Access:
Input/Output:
See also: ERRM, ERRN, ERR0

DOLIST

Type: Command
Description: Do to List Command: Applies commands, programs, or user-defined functions to lists.
The number of lists, n, can be omitted when the first or level 1 argument is any of the following:
• A command.
• A program containing exactly one command (e.g. « DUP »)
• A program conforming to the structure of a user-defined function.
The final argument 1 (or level 1 object) can be a local or global name that refers to a program or
command.
All lists must be the same length l. The program is executed l times: on the ith iteration, n objects
each taken from the ith position in each list are entered on the stack in the same order as in their
original lists, and the program is executed. The results from each execution are left on the stack.
After the final iteration, any new results are combined into a single list.
!°
Access:
Input/Output:
See also: DOSUBS, ENDSUB, NSUB, STREAM
display the corresponding built-in error message.
error
ERROR DOERR
Level 1/Argument 1
n
error
#n
error
"error"
0
LIST PROCEDURES DOLIST
L /A ... L /A
n+2 1 3 n–2
{ list } ... { list }
1 n
{ list } ... { list }
1 n
{ list } ... { list }
1 n
{ list } ...
1
{ list } ...
1
{ list } ...
1
L = Level; A = Argument
( °is the left-shift of the Nkey).
( °is the left-shift of the Nkey).
L /A L /A
2 n+1 1
n « program »
n command
n name
{ list } « program »
n+1
{ list } command
n+1
{ list } name
n+1
Full Command and Function Reference 3-49
Level 1/Item 1
Level 1/Item 1
n+2
{ results }
{ results }
{ results }
{ results }
{ results }
{ results }