Skip to main content
Open topic with navigation CAPL Functions » System Variables » sysGetVariableLongLong

​
sysGetVariableLongLong

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

​
Function Syntax

  • int64 sysGetVariableLongLong(char namespace[], char variable[]); // form 1
  • int64 sysGetVariableLongLong(SysVarName); // form 2
  • long sysGetVariableLongLong(char namespace[], char variable[], int64& value); // form 3
  • long sysGetVariableLongLong(SysVarName, int64& value); // form 4

​
Description

Returns the value of a variable of a 64 bit integer type. Note
  • Direct access to values from system variables.
  • The function can also be used for specific elements of a system variable of type struct or generic array. For this, add the element to the name of the variable. If you directly give the element name to the function instead of using strings, precede the name by sysvarMember:: instead of sysvar::. Example: sysvarMember::SomeNamespace::SomeStructVariable.SomeArrayMember[0]
  • The function can also be used for variables of type unsigned 64bit integer. You can simply cast the result to qword.

​
Parameters

  • namespace: Name of the namespace.
  • variable: Name of the variable.
  • value: Receives the current value 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::”.

​
Return Values

  • Value of the variable or 0 in case of error (form 1 and 2)
    • 0: no error, function successful (form 3 and 4)
    • 2: variable was not found or second try to define the same variable (form 3 and 4)
    • 4: the variable has no suitable type for the function (form 3 and 4)

​
Example

sysGetVariableLongLong(sysvar::MyNamespace::Int64Var);