CAPLfunctionTestCheckConstraint

TestCheckConstraint

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

Function Syntax

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

Description

Checks whether the specified constraint 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 Test Service 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 constraint

// checks the maximum duration of a sequence of actions
checkId = ChkStart_Timeout (1000);
TestAddConstraint (checkId);
TestWaitForTimeout(1500);
result = TestCheckConstraint(checkId);
if (result == 1)
      TestStepFail("Timeout already occurred after 1500 ms.");
// sequence of different actions and waiting conditions
TestRemoveConstraint (checkId);

Example 2

Add text event as constraint

// test case to check if Error Frames occur
testcase CheckErrorFrameReceived ()
{
    TestAddConstraint ("ErrorFrameReceived");
    TestWaitForTimeout(1000);
    result = TestCheckConstraint("ErrorFrameReceived");
    if (result == 1)
          TestStepFail("Error Frame already occurred after 1000 ms.");
    // sequence of different actions and waiting conditions
    TestRemoveConstraint("ErrorFrameReceived");
}

// handler to supply text event
on errorFrame
{
    TestSupplyTextEvent("ErrorFrameReceived");
}

TestAddConstraint • TestSupplyTextEvent