forEachReversed

From Bohemia Interactive Community
Revision as of 12:42, 12 March 2024 by Lou Montana (talk | contribs) (Some wiki formatting)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
Executes the given command(s) on every item of an Array in reversed order, compared to forEach.
Groups:
Program FlowArrays

Syntax

Syntax:
code forEachReversed array
Parameters:
code: Code to execute on each array item - available variables:
array: Array - the array to iterate over
Return Value:
Anything - will return the value of last executed statement

Examples

Example 1:
This command lets you easily iterate through an array from last to first element without modifying the array itself with reverse or using for loop with negative step.
// Will show numbers from 5 to 1 in the chat { systemChat str _x } forEachReversed [1, 2, 3, 4, 5];
Example 2:
Can be useful to walk through array while also deleting items from it, which you couldn't do with forEach as easily:
private _array = [1, 1, 2, 2, 1, 1, 2, 2]; { if (_x == 2) then { _array deleteAt _forEachIndex }; } forEachReversed _array; // _array will be [1,1,1,1] here
Will not work with forEach as you might expect it:
private _array = [1, 1, 2, 2, 1, 1, 2, 2]; { if (_x == 2) then { _array deleteAt _forEachIndex }; } forEach _array; // _array will be [1, 1, 2, 1, 1, 2] here
Example 3:
Deleting items from array with more complex condition than just comparison.
{ if (!alive _x) then { _vehicles deleteAt _forEachIndex }; } forEachReversed _vehicles;

Additional Information

See also:
Control Structures forEach for apply while select findIf count deleteAt reverse

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