tchmi_equal

[ Funktion ]

function tchmi_equal(value1: any, value2: any, bTypeSafe: boolean = true): boolean;

Prüft zwei Variablen auf Wertgleichheit.

In JavaScript werden einfache Datentypen (wie Booleans oder Zahlen) bei Verwendung kopiert (by value). Ist ein Datentyp jedoch komplex wird eine Referenz genutzt (by reference), so dass eine Manipulation der vermeintlichen Kopie den Ursprungswert mit verändert.

Ein Vergleich auf Gleichheit ist bei Werten wie zum Beispiel einer SolidColor nicht trivial, da der einfache === Operator hier die Referenzen aber nicht den Inhalt prüft.

Die Funktion tchmi_equal kann stattdessen genutzt werden.

Parameter

Rückgabewert

Verfügbar ab Version 1.8

Beispiel - JavaScript

var myColor = {color: 'red'};
var myColor2 = {color: 'red'};
TcHmi.Log.debug(
    'JS compare: ' + (myColor === myColor2) + 
    ' tchmi_equal: ' + tchmi_equal(myColor, myColor2)); // JS compare: false tchmi_equal: true