improve 'CBA_fnc_sortNestedArray'

[commy2]

• makes CBA_fnc_sortNestedArray use SQFs native sort command
• adds optional parameter to reverse sorting order

BIS_fnc_sortBy is using the same method now

[PabstMirror]

Could do:

    {
        _array set [_forEachIndex, _x select 1];
    } forEach _helperArray;

[thojkooi]

_array = _helperArray apply {_x select 1};

[bux]

apply is 1.56, so it won't work with the linux builds that are on 1.54(iirc).

[thojkooi]

It would have been so beautiful.

[commy2]

CBA_fnc_sortNestedArray originally modified the array by reference, which means select and apply cannot be used. Even if you reassign the new array to the previous variable, it wouldnt behave the same.

blah = [0];
player setVariable ["blah", _blah];
blah set [0, 1];
player getVariable "blah";
-> 1

vs.

blah = [0];
player setVariable ["blah", _blah];
blah = blah apply {1};
player getVariable "blah";
-> 0

This is why select, apply and arrayIntersect are not as versatile as they could've been...

[bux]

Creating a new array is kind of industry standard though. And I'm happy BIS used that approach.

[commy2]

This function defies the standard, but we should go with bwc always.

[Killswitch00]

Should the "optional: true" comment mean that 1) it is optional and 2) the default is "true"? In that case,
(optional, default: true) would be easier to understand.