FindAction

Description:              This function returns an action from the list of actions in a state.

Returns:                    Pointer

Usage:                       Script

Format:                      FindAction(Action, Mode)

Parameters:             Action    { varies }  { required }  { no default: }

                                      Any expression that gives a code value. If the code value represents a module and state, the first action will be returned. If the code value represents an action or statement, the action returned will depend on Mode.

                                    Mode    { numeric }  { required }  { no default: }

                                      Any numeric expression for the mode. The mode is described by the following table:

Value

Mode

-1

Previous action

0

Return Action parameter

1

Next action

 

                             If Mode is 1, and Action is the last action in the state, or if Mode is –1, and Action is the first predicate in the state, the return value is invalid.

Comments:               This function is used to step through the actions in a state.