CAPLfunctionStartValuesUpdateList

Open topic with navigation

CAPL Functions » General » Function Overview » startValuesUpdateList

startValuesUpdateList

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

Note

• Call startValuesUpdateList() in the on stopMeasurement CAPL event handler to save the last variable or signal values, for which start values are defined, for the next measurement start.
• If you change the value of a variable or signal value in a CAPL event handler, you cannot call startValuesUpdateList() in the same handler to save the values just set as start values. The variable or signal value is only changed after the function call startValuesUpdateList(). Decouple the call to startValuesUpdateList() via a timer from setting the variable or signal value. Refer to example 2 below.

Function Syntax

void startValuesUpdateList(); // form 1
void startValuesUpdateList(char groupName[]); // form 2
void startValuesUpdateList(char groupName[], long onlyActiveStartValues); // form 3

Description

Sets the start values of variables/signals in the CANoe DE product Start Value Window to the currently measured values.

Parameters

• groupName: Name of a group containing start values. If groupName is defined, then only the active start values contained in this group get the currently measured values. If groupName is not defined or is equal to "", then only the active start values of all groups get the currently measured values.

• onlyActiveStartValues: Determines if active start values get the currently measured values or not. If missing, then only the active start values are considered.

  • 1: Only the active start values get the currently measured values.
  • 0: All start values (active and inactive) get the currently measured values.

Return Values

—

Example

Example 1

on key '1'
{
  startValuesUpdateList("Start values group1");
}

on key '2'
{
  startValuesUpdateList();
}

on key '3'
{
  startValuesUpdateList(""); // corresponds to startValuesUpdateList();
}

on key '4'
{
  startValuesUpdateList("Start values group1", 1);
}

on stopMeasurement
{
  startValuesUpdateList();
}

Example 2

variables
{
  msTimer t;
}
on timer t
{
  startValuesUpdateList();
}
on key '5'
{
  @myVariable = 123;

  //startValuesUpdateList();    // this call would not save the value 123 of myVariable
  //because the variable is set later than the function call is executed.

  setTimer(t, 0);
}

startValuesUpdateSymbols