isEqualTo

1.16

Hover & click on the images for description

Description

Description:

Performs strict comparison between var1 and var2 and returns true if equal, otherwise false. Strict means that it would check that both arguments are of the same data type and then compare the values.

Some differences between isEqualTo and ==:

• It performs case sensitive comparison on Strings
• It doesn't throw error when comparing different types, i.e. ("eleven" isEqualTo 11)
• It can compare Arrays, Scripts and Booleans (alive player isEqualTo true)
• It can compare non-existent game objects (grpNull isEqualTo grpNull)
• It can compare Namespaces (As of Arma 3 v1.47)
• It is slightly faster than ==, especially when comparing Strings

Groups:

Uncategorised

Syntax

Syntax:

var1 isEqualTo var2

Parameters:

var1: Anything

var2: Anything

Return Value:

Boolean

Examples

Example 1:

_arr1 = [1,[2,[3]]]; _arr2 = [1,[2,[3]]]; if (_arr1 isEqualTo _arr2) then {hint "Arrays match!"}

Example 2:

if (a isEqualTo b) then {hint "a is equal to b"}; if !(a isEqualTo b) then {hint "a is not equal to b"};

Additional Information

See also:

isEqualTypeAllisEqualTypeAnyisEqualTypeisEqualTypeParamsisEqualTypeArraytypeNameOperatorsinfindsetresizeswitcha == b

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Bottom Section

Posted on July 19, 2014 - 19:48 (UTC)

AgentRevolution

The behavior of "var1 isEqualTo var2" is pretty much equivalent to "var1 in [var2]", plus the ability to compare arrays, and slightly better performance.

Posted on December 3, 2014 - 13:11 (UTC)

Tajin

Simply put, "isEqualTo" is a binary comparison. Therefor it is very fast but only accepts 100% identical matches. In some other languages this is known as "===" instead of "==".

Posted on May 21, 2015 - 11:26 (UTC)

Killzone Kid

A faster, case-sensitive alternative to BIS_fnc_areEqual using isEqualTo: KK_fnc_allEqual = { private ["_arr", "_first"]; _arr = []; _first = _this select 0; for "_i" from 0 to count _this - 1 do { _arr pushBack _first; }; _arr isEqualTo _this }; // Example [[1,2],[1,2],[1,3]] call KK_fnc_allEqual; //false

Posted on May 21, 2015 - 15:30 (UTC)

Killzone Kid

Array "compare" implementation using isEqualTo, a faster, case-sensitive alternative to BIS_fnc_arrayCompare: KK_fnc_compare = { _this select 0 isEqualTo (_this select 1) }; // Example [[1,2,3],[1,2,3]] call KK_fnc_compare; //true