readEx

[ Funktion ]

Version 1.8

public static readEx(expression: string): any;

Version 1.12

public static readEx<T = any>(expression: string): T;

Liest den Wert eines Symbols adressiert über den Symbolausdruck.

Ab Version 1.10 werden Symbol-Abfragen direkt gegen die Komponente ausgeführt, welche die Daten zur Verfügung stellt. Da eine synchrone Abfrage von Symbolen aus dem Server nicht möglich ist, verwenden Sie zum Abfragen von Server-Symbolen bitte die Funktion readEx2.

Version 1.12: Wird die API in TypeScript-Code benutzt, so kann dem TypeScript-Compiler mitgeteilt werden, welchen Typ der Symbolwert hat.

Dies ist eine reine Hilfe für die Programmierung. Der Browser kennt diese „Typeannotation“ nicht. Es findet keine Prüfung oder Konvertierung zur Laufzeit statt.

Parameter

Rückgabewert

Verfügbar ab Version 1.8

Beispiel - JavaScript

var symVal = TcHmi.Symbol.readEx('%i%myInternalSym%/i%');

Beispiel 1 - TypeScript

let symVal = TcHmi.Symbol.readEx('%i%myInternalSym%/i%'); // TS does not know the variable type

Beispiel 2 - TypeScript

let thisIsABoolean = TcHmi.Symbol.readEx<boolean>('%i%myInternalSym%/i%'); // TS knows this is a boolean