Assert_ArrayOfLReal_NotEqual (FUN) ¶ FUNCTION Assert_ArrayOfLReal_NotEqual : BOOL Assertion function to check that two ARRAY OF LREAL are not equal. Two arrays are not equal if at least one of the following conditions is not met: * the two arrays have the same bounds * for each index the values of both arrays are equal InOut: Scope Name Type Initial Comment Return Assert_ArrayOfLReal_NotEqual BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceArray POINTER TO LREAL The reference array to check actualArray POINTER TO LREAL The array to check precision LREAL 0.0 A value to specify an allowed deviation. Default is 0.0 wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .

Assert_ArrayOfReal_Contains (FUN) ¶ FUNCTION Assert_ArrayOfReal_Contains : BOOL Assertion function to check that an ARRAY OF REAL contains a specific value InOut: Scope Name Type Initial Comment Return Assert_ArrayOfReal_Contains BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceValue REAL The value that should be contained actualArray POINTER TO REAL The array to check precision REAL 0.0 A value to specify an allowed deviation. Default is 0.0 wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .

Testcase (FB) ¶ FUNCTION_BLOCK Testcase EXTENDS Testcase_Base IMPLEMENTS IBaseIecUnitTest Base class for a simple test case. To implement a testcase: Extend your test from this function block Add {attribute 'test'} to the FB, so that it is identified as a test Optionally add any of the following attributes as desired {attribute 'testcategory':='<add categories here>'} {attribute 'testcasename':='<new name>'} to use a testcasename other then the FB name {attribute 'testcasetimeout':='<timeout in ms>'} to alter the default timeout for this test Add a call to SUPER^() to your implementation of the FB. Overwrite method Execute() to implement your test Optionally overwrite any of the following methods as desired |Testcase_Base.Setup| |Testcase_Base.Abort| |Testcase_Base.Teardown| InOut: Scope Name Type Comment Inherited from Input xExecute BOOL Rising edge: Action starts Falling edge: Resets outputs If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values ( xDone , xError , iError ) are present at the outputs for exactly one cycle. ETrigA xAbort BOOL TRUE : Action is stopped immediately and all outputs are reset to their initial values. ETrigA Output xDone BOOL TRUE : Action successfully completed ETrigA xBusy BOOL TRUE : Function block active ETrigA xError BOOL TRUE : Error occurred, function block aborts action FALSE : No error ETrigA xAborted BOOL TRUE : Action aborted by user ETrigA xFinished BOOL Testcase_Base sInfo WSTRING(Constants.WSTRING_LENGTH) additional information (e.g. an error text) Methods: Execute HandleAssertResult HasError Structure: Execute (Method) HandleAssertResult (Method) HasError (Method)

Testcase.Execute (METH) ¶ METHOD PROTECTED Execute : BOOL Overwrite this method to implement the logic of this testcase. Once the test has been started, this method will be called until a) the method returns TRUE , which signals completion of the test, or the test is aborted. Once this method returns TRUE , the output iErrorCode is evaluated: The value 0 signals success, while all other values signal a failure of the test. To provide additional information about the test, set the global output sInfo of the base FB. DO NOT CALL the base implementation of this method SUPER^.Execute() . InOut: Scope Name Type Return Execute BOOL Output iErrorCode INT

Testcase.HandleAssertResult (METH) ¶ METHOD HandleAssertResult : BOOL InOut: Scope Name Type Return HandleAssertResult BOOL Input eAssertion_Result ASSERTION_RESULT wsErrorMsg WSTRING(Constants.WSTRING_LENGTH)

Testcase.HasError (METH) ¶ METHOD HasError : BOOL InOut: Scope Name Type Return HasError BOOL

Functions ¶ AssignBool (Function) BoolCompareToPWS (Function) CreateAssertionErrorMessageForArrayContent (Function) CreateAssertionErrorMessageForInterface (Function) CreateAssertionErrorMessageForStandardDatatype (Function) CreateAssertionErrorMessageForStandardDatatypeSingleValue (Function) CreateAssertionErrorMessageNonEqualArrayBounds (Function)

AssignBool (FUN) ¶ FUNCTION AssignBool : BOOL The function helps to set a boolean variable by using the enumaration BOOLASSIGN InOut: Scope Name Type Return AssignBool BOOL Input pValue POINTER TO BOOL eAssign BOOLASSIGN

BoolCompareToPWS (FUN) ¶ FUNCTION BoolCompareToPWS : POINTER TO WSTRING InOut: Scope Name Type Return BoolCompareToPWS POINTER TO WSTRING Input eCompareValue BOOLCOMPARE

CreateAssertionErrorMessageForArrayContent (FUN) ¶ FUNCTION CreateAssertionErrorMessageForArrayContent Helper function to create an error message for assertions that failed because of the content of an array. Hint: for longer arrays or if wsErrorMsg is used, it is recommended to change the value of the library parameter Constants.WSTRING_LENGTH . InOut: Scope Name Type Comment Inout wsAssertError WSTRING(Constants.WSTRING_LENGTH) Inout Const wsAssertOperator WSTRING(Constants.WSTRING_LENGTH) The assert operator e.g. Strings.EQUAL or “CONTAINS SEQUENCE” wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) A custom error message that should be appended. If no message is provided the “Additional information” part will not be added to the returned error. wsActualValues WSTRING(Constants.WSTRING_LENGTH) The values of the actual array as WSTRING wsReferenceValues WSTRING(Constants.WSTRING_LENGTH) The values of the actual array as WSTRING