Extensions.Assertion.Assert
Classification
Name | Assert |
Short Description | - |
Class | Action |
Extension | OTX Assertion extension |
Group | - |
Exceptions | - |
Checker Rules | - |
Standard Compliant | Yes |
OTL Syntax
Assertion.Assert(BooleanTerm condition, StringTerm errorMessage);
Description
If the runtime is configured to evaluate assertions: Evaluates the given boolean expression.
If the expression evaluates to true, nothing happens.
If the expression evaluates to false, the execution of OTX procedure should be stopped (the exact runtime behaviour is unspecified), and the failed assertion is reported to the runtime system itself (out of OTX scope).
If an exception occurs while evaluating the boolean expression, that exception will not be thrown. Instead, the assertion will fail.
If the runtime is configured not to evaluate this assertion: Does nothing. In particular, the boolean condition will not be evaluated.
Properties
Name | Data Type | Class | Default | Cardinality | Description |
Condition | Boolean | Term | - | [1..1] | The expression to evaluate. |
ErrorMessage | String | Term | - | [0..1] | An error message which may be included in the report to the runtime system, if the assertion fails. |
OTL Examples
/// Local Declarations
/// Flow
Assertion.Assert(1 == 1, "the expression evaluates to true");
Assertion.Assert(1 != 1, "the expression evaluates to false");
Assertion.Assert((1/0) == 0, "an exception occurs while evaluating the boolean expression");