Skip to main content

Documentation Index

Fetch the complete documentation index at: https://notevil.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Open topic with navigation CAPL Functions » System Variables » sysBeginVariableStructUpdate

​
sysBeginVariableStructUpdate

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

​
Function Syntax

  • long sysBeginVariableStructUpdate(char namespace[], char variable[]); // form 1
  • long sysBeginVariableStructUpdate(sysvarName); // form 2

​
Description

Starts the update of several elements of a system variable of type struct or generic array. Use this function and the corresponding sysEndVariableStructUpdate to change several elements at the same time without the variable having an intermediate value where only some elements are changed. Each call must be followed by a call to sysEndVariableStructUpdate, else the variable value will not change.

​
Parameters

  • namespace: Name of the namespace.
  • variable: Name of the variable. SysVarName: Name of the fully qualified name of the system variable, including all namespaces, separated by ”::”. The name must be preceded by “sysVar::”.
  • SysVarName: Name of the fully qualified name of the system variable, including all namespaces, separated by ”::”. The name must be preceded by “sysVar::”.

​
Return Values

  • 0: no error, function successful
  • -1: variable was not found

​
Example

sysBeginVariableStructUpdate(sysvar::XCP::ECU_2::KL2);