Copyright (c) Hyperion Entertainment and contributors.
AmigaOS Manual: ARexx Instructions
An instruction clause begins with the name of a particular instruction and tells ARexx to perform a certain action. This chapter provides an alphabetical list of the instructions available in ARexx.
Each instruction keyword may be followed by one or more subkeywords, expressions, or other instruction-specific information. Instruction keywords and subkeywords are recognized only in this specific context. This allows the same keywords to be used in a different context as variables or function names. An instruction keyword cannot be followed by a colon (:) or an equals (=) operator.
Syntax
The syntax for each instruction is shown to the right of the keyword heading. The conventions used in the syntax are shown in Table 4-1:
| Convention | Definition |
|---|---|
| KEYWORD | All keywords and subkeywords are shown in uppercase letters |
| | (vertical bar) | Alternative selections are separated by a vertical bar |
| { } (braces) | Required alternatives are enclosed by braces |
| [ ] (brackets) | Optional instruction parts are enclosed in brackets |
| Note |
|---|
| The syntax conventions do not apply to the specifications following the keyword heading. They only apply to the syntax shown to the right of the instruction keyword. |
For example, the format for the CALL instruction is:
CALL {symbol | string} [expression] [,expression,...]
You must supply a symbol or a string as an argument. The vertical bar identifies the alternative selections, and the braces indicate that the use of an argument is required. The specification of an expression is optional, as indicated by the brackets.
Examples are given at the end of the instruction specification. Explanations or evaluations of the examples are shown as ARexx comments /*...*/.
