Condition   built-in function

The Condition function returns requested information about the currently trapped condition.

result = Condition( [ option ] )

option

May be one of the following:

  Condition name -- returns the name of the current condition

  Description -- returns descriptive information associated with the current condition

  Instruction -- returns 'SIGNAL' or 'CALL' depending on which type of statement is associated with the current condition.

  State -- returns the state of the current condition The state is one of:

    ON -- the condition is enabled

    OFF -- the condition is disabled

    DELAY -- a new condition of the same type will be delayed or ignored

When option is omitted, the function returns 'SIGNAL' or 'CALL' depending on which type of statement is associated with the current condition.

Examples: say Condition() -- shows the instruction associated with the condition say Condition( 'C' ) -- shows the current condition name say Condition( 'D' ) -- shows descriptive information associated with the condition say Condition( 'I' ) -- shows the instruction associated with the condition say Condition( 'S' ) -- shows the state of the current condition