constructor

[ Funktion ]

public constructor(expression: string);

Erstellt eine Symbol Instanz.

Instanzen die mit new erstellt wurden, müssen zwingend durch Aufruf der destroy Funktion zerstört werden, wenn sie nicht mehr benötigt werden.

Version 1.12: Wird die API in TypeScript-Code benutzt, so kann beim Erstellen eines Symbols dem TypeScript-Compiler mitgeteilt, welchen Typ der beschriebene Symbolwert hat. Dieser muss dann beispielsweise bei Nutzung der Funktion read nicht mehr angegeben werden.

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

Beispiel - JavaScript

var symbol = new TcHmi.Symbol('%i%myInternalSym%/i%');
symbol.readEx(function(data) {
   // Do something with data.value…
   symbol.destroy();
   symbol = null;
   return;
});

Beispiel 1 - TypeScript

var symbol: null | TcHmi.Symbol = new TcHmi.Symbol('%i%myInternalSym%/i%');
symbol.readEx(function(data) {
   // Do something with data.value…
   symbol?.destroy();
   symbol = null;
   return;
});

Beispiel 2 - TypeScript

var symbol: null | TcHmi.Symbol<boolean> = new TcHmi.Symbol<boolean>('%i%myInternalSym%/i%');
symbol.readEx(function(data) {
   let thisIsABoolean = data.value; // TS knows this is a boolean
   // Do something…
   symbol?.destroy();
   symbol = null;
   return;
});

Verfügbar ab Version 1.8