beautypg.com

Operators – AMT Datasouth PAL User Manual

Page 27

background image

4. Operators

This section uses a consistent set of notation rules to summarize the operation of the numerous
operators available under the PAL language. The operator usage summary lines show the operator
written in a

monospaced bold font

. For easier reading, this manual also uses a sans-serif

upright font for operators listed within the main text.

The list of objects which the operator expects to find on the operand stack appear to the left of the
operator. The list of objects which the operator leaves on the operand stack appear to the right of
the operator.

The text refers to the objects which the operator expects to find on the stack as the operator's pa-
rameters
. The text refers to the objects which the operator leaves on the stack as the operator's re-
sults
.

The operator usage summary lines use tokens to represent the positions of each parameter or result
object. The text shows tokens in a sans-serif italic font.

The usage summary lines may enclose some parameters in square brackets — "[" and "]". Square
brackets enclose optional parameters which the programmer may omit when not required. Usage
summary lines may also use an abbreviated ellipse ("..") to indicate a range of parameters.

The name of every token shown includes a suffix which indicates the object type for the parameter
or result. The following table lists the suffixes and their associated object types.

Suffix

Object Type

Any

Any

Array

Array

Bool

Boolean

Dict

Dictionary

File

File

Int

Integer

Mark

Mark

Name

Name

Null

Null

Num

Fixed-Point or Integer

Proc

Procedure

Str

String

Text

Name or String