isEqualTo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(compares values not variables)
m (template:command argument fix)
Line 15: Line 15:
* It can compare non-existent game objects ([[grpNull]] [[isEqualTo]] [[grpNull]])
* It can compare non-existent game objects ([[grpNull]] [[isEqualTo]] [[grpNull]])
* It can compare [[Namespace]]s (''As of Arma 3 v1.47'')
* It can compare [[Namespace]]s (''As of Arma 3 v1.47'')
* It is slightly faster than [[==]], especially when comparing [[String]]s |= Description
* It is slightly faster than [[==]], especially when comparing [[String]]s |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| val1 '''isEqualTo''' val2 |= Syntax
| val1 '''isEqualTo''' val2 |SYNTAX=


|p1= val1: [[Anything]] |= Parameter 1
|p1= val1: [[Anything]] |PARAMETER1=
|p2= val2: [[Anything]] |= Parameter 2
|p2= val2: [[Anything]] |PARAMETER2=


| [[Boolean]] |= Return value
| [[Boolean]] |RETURNVALUE=
____________________________________________________________________________________________
____________________________________________________________________________________________
   
   
|x1= <code>_arr1 = [1,[2,[3]]];
|x1= <code>_arr1 = [1,[2,[3]]];
_arr2 = [1,[2,[3]]];
_arr2 = [1,[2,[3]]];
[[if]] (_arr1 [[isEqualTo]] _arr2) [[then]] {[[hint]] "Arrays match!"}</code> |= Example 1
[[if]] (_arr1 [[isEqualTo]] _arr2) [[then]] {[[hint]] "Arrays match!"}</code> |EXAMPLE1=


   
   
|x2= <code>[[if]] (a [[isEqualTo]] b) [[then]] {[[hint]] "a is equal to b"};
|x2= <code>[[if]] (a [[isEqualTo]] b) [[then]] {[[hint]] "a is equal to b"};
[[if]] !(a [[isEqualTo]] b) [[then]] {[[hint]] "a is not equal to b"};</code> |= Example 2
[[if]] !(a [[isEqualTo]] b) [[then]] {[[hint]] "a is not equal to b"};</code> |EXAMPLE2=


____________________________________________________________________________________________
____________________________________________________________________________________________


| [[isEqualTypeAll]], [[isEqualTypeAny]], [[isEqualType]], [[isEqualTypeParams]], [[isEqualTypeArray]], [[typeName]], [[Operators]], [[in]], [[find]], [[set]], [[resize]], [[switch]], [[a == b]] |= See also
| [[isEqualTypeAll]], [[isEqualTypeAny]], [[isEqualType]], [[isEqualTypeParams]], [[isEqualTypeArray]], [[typeName]], [[Operators]], [[in]], [[find]], [[set]], [[resize]], [[switch]], [[a == b]] |SEEALSO=


}}
}}

Revision as of 15:41, 7 April 2019

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 ==:
Groups:
Uncategorised

Syntax

Syntax:
val1 isEqualTo val2
Parameters:
val1: Anything
val2: 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

Notes

Bottom Section

Posted on July 19, 2014 - 19:48 (UTC)
AgentRev
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 November 3, 2016 - 02:39 (UTC)
Dedmen
When comparing with nil result is Nothing. "nil isEqualTo player" returns "Nothing" instead of expected "false" diag_log [nil isEqualTo player]; Will print "[bool]" diag_log (str (nil isEqualTo player)) + "test"; Will throw Generic error in expression "+: Type Nothing, expected Number,Array,String,Not a Number"