Skip to main content

​
TestCheckCondition

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

​
Function Syntax

long TestCheckCondition (dword aAuxHandle);
long TestCheckCondition (char aEventText[]);

​
Description

Checks whether the specified condition was already injured. This function can be used both within a test case and also on test module level.

​
Parameters

  • aAuxHandle: Event object, for example a check from the TestService Library. Specified is the handle that is returned on creation of a check. This function can be used both within a test case and also on the test module level.
  • aEventText: Textual name of an event whose occurrence should be monitored. This event can be triggered with the function TestSupplyTextEvent.

​
Return Values

  • 1: Condition was already injured at least once
  • 0: Condition was not yet injured
  • < 0: The function cannot be executed because, for example, the specified condition does not exist

​
Example

Example 1 Add check as condition 
// checks the maximum duration of a sequence of actions
checkId = ChkStart_Timeout (1000);
TestAddCondition(checkId);
TestWaitForTimeout(1500);
result = TestCheckCondition(checkId);
if (result == 1)
    TestStepFail("Timeout already occurred after 1500 ms.");
// sequence of different actions and waiting conditions
TestRemoveCondition(checkId);
Example 2 Add text event as condition 
// test case to check if Error Frames occur
testcase CheckErrorFrameReceived ()
{
    TestAddCondition("ErrorFrameReceived");
    TestWaitForTimeout(1000);
    result = TestCheckCondition("ErrorFrameReceived");
    if (result == 1)
        TestStepFail("Error Frame already occurred after 1000 ms.");
    // sequence of different actions and waiting conditions
    TestRemoveCondition("ErrorFrameReceived");
}
// handler to supply text event
on errorFrame
{
    TestSupplyTextEvent("ErrorFrameReceived");
}
TestAddCondition • TestSupplyEvent