Funktion „Read variable value by name“
Index-Gruppe: IdxGrp = 0x122300 + Kanal_ID
Index-Offset: IdxOffs = 0x48
Lesen über Namen | Mit dieser Funktion kann der Wert einer Variablen über ihren Namen gelesen werden. |
Übergabeparameter: (hier mit Angabe der Stream-Offsets)::
0 |
Variablenname mit Nullterminierung |
wobei
Inhalt | Typ | Größe |
Variablenname (mit Instanzkennung bei achsspezifischen Variablen) | STRING | variabel, max. 256 Byte |
=> Streamlänge 256 Byte
Rückgabewert: (hier mit Angabe der Stream-Offsets)::
0 |
Variablenwert |
wobei
Inhalt | Typ | Größe |
Variablenwert | String, REAL64, SGN32, REAL64[ ], SGN32[ ][ ], ... | variabel, max. 2048 Byte |
=> Streamlänge max. 2048 Byte
Bei einer Array-Variablen kann neben einem Einzelwert auch das komplette Feld gelesen werden, in dem im Variablennamen keine Indizes angegeben werden.
Beispiel Variable V.G.array[0 .. 9]:
Variablenname | Rückgabewert |
V.G.array[4] | Wert des 5. Elements V.G.array[4] |
V.G.array | Wert der Array-Elemente 0 - 9 |
Anwendungsbeispiele
Beispiel für das Lesen eines Arrayelements eines eindimensionalen Arrays:
Übergabeparameter:
V.E.Testvar[3] | 0 |
V.E.Testvar[3] Name der Variable
0 Nullterminierung
Rückgabewert:
333 |
333 Variablenwert des Elements
Beispiel für das Lesen eines gesamten Arrays mit 5 Elementen:
Übergabeparameter:
V.E.Testvar | 0 |
V.E.Testvar Name der Variable
0 Nullterminierung
Rückgabewerte:
123 | 234 | 345 | 456 | 567 |
123 Wert des 1.Element
234 Wert des 2.Element
345 Wert des 3.Element
456 Wert des 4.Element
567 Wert des 5.Element