Difference between revisions of "Extensions.Assertion.Assert"
Jump to navigation
Jump to search
Line 9: | Line 9: | ||
== Description == | == Description == | ||
− | If the runtime is configured to evaluate assertions: Evaluates the given boolean expression. | + | If the runtime is configured to evaluate assertions: Evaluates the given [[Core.DataTypes.SimpleDataType.Boolean|boolean]] expression. |
If the expression evaluates to true, nothing happens. | If the expression evaluates to true, nothing happens. | ||
Line 15: | Line 15: | ||
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 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 an exception occurs while evaluating the [[Core.DataTypes.SimpleDataType.Boolean|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. | + | If the runtime is configured not to evaluate this assertion: Does nothing. In particular, the [[Core.DataTypes.SimpleDataType.Boolean|boolean]] condition will not be evaluated. |
== Properties == | == Properties == |
Latest revision as of 09:36, 23 September 2019
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");