readEx2

[ Funktion ]

Version 1.10

public static readEx2(
    expression: string,
    callback?: (data: Symbol.IReadResultObject) => void
): void;

Version 1.12

public static readEx2<T = any>(
    expression: string,
    callback?: (data: Symbol.IReadResultObject<T>) => void
): DestroyFunction;

Liest den Wert eines Symbols adressiert über den Symbolausdruck.

Der Aufruf der Callback Funktion erfolgt in Abhängigkeit des verwendeten Symbol Typs entweder synchron oder asynchron.

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.10

Beispiel - JavaScript

TcHmi.Symbol.readEx2('%s%PLC1.MAIN.sTest%/s%', function (data) {
    if (data.error === TcHmi.Errors.NONE) {
        // Handle result value... 
        var value = data.value; 
        console.log(value); 
    } else {
        // Handle error... 
    }
});

Beispiel 1 - TypeScript

TcHmi.Symbol.readEx2('%s%PLC1.MAIN.sTest%/s%', function (data) {
    if (data.error === TcHmi.Errors.NONE) {
        // Handle result value... 
        var value = data.value; // TS does not know the variable type
        console.log(value); 
    } else {
        // Handle error... 
    }
});

Beispiel 2 - TypeScript

TcHmi.Symbol.readEx2<string>('%s%PLC1.MAIN.sTest%/s%', function (data) {
    if (data.error === TcHmi.Errors.NONE) {
        // Handle result value... 
        let thisIsAString = data.value; // TS knows this is a string
        console.log(thisIsAString); 
    } else {
        // Handle error... 
    }
});