apply

1.56

Hover & click on the images for description

Description

Description:

Applies given code to each element of the array and returns resulting array. The value of the current array element, to which the code will be applied, is stored in variable _x.

Groups:

Arrays

Syntax

Syntax:

array apply code

Parameters:

array: Array - Array of Anything

code: Code - Code to be executed on each element of the array. Current element value is stored in variable _x

Return Value:

Array - Resulting array

Alternative Syntax

Syntax:

hashmap apply code

Parameters:

hashmap: HashMap

code: Code - Code to be executed on each element of the hashmap. Current key is stored in variable _x, and the value is stored in variable _y

Return Value:

Array - Resulting array

Examples

Example 1:

_arr = [1,2,3,4,5,6,7,8,9,0] apply {[1,0] select (_x % 2 == 0)}; //[1,0,1,0,1,0,1,0,1,0]

Example 2:

_arr = [1,2,3,4,5,6,7,8,9,0] apply {_x ^ _x}; //[1,4,27,256,3125,46656,823543,16777216,387420480,1]

Example 3:

_arr1 = []; _arr1 resize 20; _arr2 = _arr1 apply {0}; //[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]

Example 4:

[0,1,2,3,4] apply {str _x}; // Returns ["0","1","2","3","4"]

Example 5:

_hashmap = createHashMapFromArray [["key", "value"]]; _array = _hashmap apply {_y}; //["value"]

Additional Information

See also:

setresizepushBackpushBackUniqueselectreversecountfindinforEachdeleteAtdeleteRangeappendsortarrayIntersect

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

Posted on February 18, 2016 - 11:03 (UTC)

Fusselwurm

(to anyone else wondering, I took a minute to get it): This is Array.map() in JavaScript

Posted on February 11, 2018 - 23:02 (UTC)

Lou Montana

if performance really is an issue, apply seems to be (very) slightly faster than forEach (by more or less one percent, 0.7-1.5% in my tests to be precise).