Exceptions handling words.
Words definition table columns:
- Name: A name of a word with optional parameters.
- Imm.: Immediate - if a word is executed even if we are in the compilation mode.
- Mode: I = interpretation mode only (not available during compilation), C = compilation mode only (not available during interpretation), IC = available in both modes.
- Description: A word name, followed by the stack diagram - () = data stack, [] = return stack, {} = object stack - and description of the word itself.
| Name | Imm. | Mode | Description |
|---|---|---|---|
| CATCH | yes | C | Catch an exception (xt -- n) Pushes the current execution state to the exception stack, executes xt, and returns 0 for no-error execution (dropping the exception frame) and non-zero, if a THROW was executed. |
| THROW | no | C | Throw an exception (n -- ) If n is zero, does nothing. Otherwise throws an error, terminating the current execution, returning to the CATCH, if a exception frame was found on the exception stack. |
| Name | Imm. | Mode | Description |
|---|---|---|---|
| ABORT | no | IC | Abort Clears the stack and the object stack and performs a QUIT. Extended versions. |
| ABORT" str | yes | C | Abort with message (flag -- ) Prints the string literal that follows in line, then aborts, clearing all execution state to return to the interpreter. Extended version. |