arrayIntersect: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| *(arg|eff|mp|serverExec|gr[0-9]) *= *(.*) * *\|([^=]{12})" to "|$1=$2 |descr=$3")
No edit summary
 
(40 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma3
|game1= arma3
|version1= 1.48


|1.48
|gr1= Arrays


|gr1= Arrays
|descr= Intersects two arrays returning an array of unique common elements, avoiding [[nil]] values.
Using the same array as both parameters will return unique elements of that array.
Intersects only the first dimension of said arrays.
{{Feature|informative|From Arma 3 v 2.14 the order of the intersected elements would follow 'array1' order}}


|descr= Intersects array1 with array2 returning array of unique common elements. Additionally, using the same array for array1 and array2 will simply return array of unique elements. Intersects only 1st dimension of an array.


|s1= array1 '''arrayIntersect''' array2
|s1= array1 [[arrayIntersect]] array2


|p1= array1: [[Array]]
|p1= array1: [[Array]]
Line 15: Line 18:
|p2= array2: [[Array]]
|p2= array2: [[Array]]


|r1=[[Array]]
|r1= [[Array]]


|x1= <code>_arr1 = [1,2,3,4,5,2,3,4];
|x1= <sqf>
_arr1 = [1,2,3,4,5,2,3,4];
_arr2 = [4,5,6,1,2,3,5,6];
_arr2 = [4,5,6,1,2,3,5,6];
[[hint]] [[str]] (_arr1 [[arrayIntersect]] _arr2); // [4,5,1,2,3]</code>
hint str (_arr1 arrayIntersect _arr2); // [4,5,1,2,3]
</sqf>


|x2= <code>_arr = [1,2,3,1,2,3,1,2,3,4,5];
|x2= <sqf>
[[hint]] [[str]] (_arr [[arrayIntersect]] _arr); // [1,2,3,4,5]</code>
_arr = [1,2,3,1,2,3,1,2,3,4,5];
hint str (_arr arrayIntersect _arr); // [1,2,3,4,5]
</sqf>


|x3= Remove [[nil]]s:<code>[[hint]] [[str]] ([1,2,[[nil]],3] [[arrayIntersect]] [1,2,[[nil]],3]); // [1,2,3]</code>
|x3= Remove [[nil]]s:
<sqf>hint str ([1,2,nil,3] arrayIntersect [1,2,nil,3]); // [1,2,3]</sqf>


|x4= Also works with array elements which are [[isEqualTo|equal]]:<code>[[hint]] [[str]] ([[1],[2],[3]] [[arrayIntersect]] [[2],[3],[4]]); // [[2],[3]]</code>
|x4= Also works with array elements which are [[isEqualTo|equal]]:
<sqf>hint str ([[1],[2],[3]] arrayIntersect [[2],[3],[4]]); // [[2],[3]]</sqf>


|x5= This command is case sensitive:<code>["cAse"] [[arrayIntersect]] ["cAse"]; {{cc|["cAse"]|true}}
|x5= This command is case-sensitive:
["cAse"] [[arrayIntersect]] ["casE"]; {{cc|[]|true}}</code>
<sqf>
["cAse"] arrayIntersect ["cAse"]; // ["cAse"]
["cAse"] arrayIntersect ["casE"]; // []
</sqf>


|seealso= [[append]], [[set]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[resize]], [[reverse]], [[count]], [[find]], [[in]], [[forEach]], [[deleteAt]], [[deleteRange]], [[sort]], [[param]], [[params]], [[toArray]], [[toString]], [[splitString]], [[joinString]], [[BIS_fnc_arrayPushStack]], [[BIS_fnc_arrayPush]]
|seealso= [[append]] [[set]] [[pushBack]] [[pushBackUnique]] [[apply]] [[select]] [[resize]] [[reverse]] [[count]] [[find]] [[in]] [[forEach]] [[deleteAt]] [[deleteRange]] [[sort]] [[param]] [[params]] [[toArray]] [[toString]] [[splitString]] [[joinString]] [[BIS_fnc_arrayPushStack]] [[BIS_fnc_arrayPush]]
}}
}}

Latest revision as of 17:12, 14 April 2023

Hover & click on the images for description

Description

Description:
Intersects two arrays returning an array of unique common elements, avoiding nil values. Using the same array as both parameters will return unique elements of that array. Intersects only the first dimension of said arrays.
From Arma 3 v 2.14 the order of the intersected elements would follow 'array1' order
Groups:
Arrays

Syntax

Syntax:
array1 arrayIntersect array2
Parameters:
array1: Array
array2: Array
Return Value:
Array

Examples

Example 1:
_arr1 = [1,2,3,4,5,2,3,4]; _arr2 = [4,5,6,1,2,3,5,6]; hint str (_arr1 arrayIntersect _arr2); // [4,5,1,2,3]
Example 2:
_arr = [1,2,3,1,2,3,1,2,3,4,5]; hint str (_arr arrayIntersect _arr); // [1,2,3,4,5]
Example 3:
Remove nils:
hint str ([1,2,nil,3] arrayIntersect [1,2,nil,3]); // [1,2,3]
Example 4:
Also works with array elements which are equal:
hint str ([[1],[2],[3]] arrayIntersect [[2],[3],[4]]); // [[2],[3]]
Example 5:
This command is case-sensitive:
["cAse"] arrayIntersect ["cAse"]; // ["cAse"] ["cAse"] arrayIntersect ["casE"]; // []

Additional Information

See also:
append set pushBack pushBackUnique apply select resize reverse count find in forEach deleteAt deleteRange sort param params toArray toString splitString joinString BIS_fnc_arrayPushStack BIS_fnc_arrayPush

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