sort: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame( +[0-9])?|Game [Vv]ersion( +[0-9])?|Game Version \(number surrounded by NO SPACES\)|Arguments in MP|MP[Aa]rg|Multiplayer Arguments( \("local" or "global"\))?|Effects|Execution|Effects...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| arma3 |Game name=
| arma3


|1.44|Game version=
|1.44


|gr1= Arrays |GROUP1=
|gr1= Arrays


| Attempts to sort given array either in ascending ([[true]]) or descending ([[false]]) order. All array elements should be one of the following types:
| Attempts to sort given array either in ascending ([[true]]) or descending ([[false]]) order. All array elements should be one of the following types:
Line 11: Line 11:
* [[Number]] - array of numbers ([1,2,3...])
* [[Number]] - array of numbers ([1,2,3...])
* [[Array]] - array of subarrays (<nowiki>[</nowiki>["a",1,2],["b",3,4],["c",5,6]...]). Subarrays should be of the same structure. Subarray elements other than [[String]] or [[Number]] will be ignored during sorting.
* [[Array]] - array of subarrays (<nowiki>[</nowiki>["a",1,2],["b",3,4],["c",5,6]...]). Subarrays should be of the same structure. Subarray elements other than [[String]] or [[Number]] will be ignored during sorting.
Mixed arrays (["a",1,[true]...]) are not supported and results are undefined. |DESCRIPTION=
Mixed arrays (["a",1,[true]...]) are not supported and results are undefined.


| array '''sort''' order|SYNTAX=
| array '''sort''' order


|p1= array: [[Array]] |PARAMETER1=
|p1= array: [[Array]]


|p2= order: [[Boolean]] - [[true]]: ascending, [[false]]: descending |PARAMETER2=
|p2= order: [[Boolean]] - [[true]]: ascending, [[false]]: descending


| [[Nothing]] |RETURNVALUE=
| [[Nothing]]
   
   
|x1= <code>_arr = [5.21725,1.30859,4,5.03028,1];
|x1= <code>_arr = [5.21725,1.30859,4,5.03028,1];
_arr [[sort]] [[true]];
_arr [[sort]] [[true]];
[[hint]] [[str]] _arr; //[1,1.30859,4,5.03028,5.21725]</code> |EXAMPLE1=
[[hint]] [[str]] _arr; //[1,1.30859,4,5.03028,5.21725]</code>


|x2= <code>_dev = ["ja","pa","pa","tram","tara"];
|x2= <code>_dev = ["ja","pa","pa","tram","tara"];
_dev [[sort]] [[false]];
_dev [[sort]] [[false]];
[[hint]] [[str]] _dev; //["tram","tara","pa","pa","ja"]</code> |EXAMPLE2=
[[hint]] [[str]] _dev; //["tram","tara","pa","pa","ja"]</code>


|x3= <code><nowiki>#</nowiki>define ASC true
|x3= <code><nowiki>#</nowiki>define ASC true
Line 33: Line 33:
_scores = [<nowiki/>[123,"bob",15],[123,"bill",20],[200,"dave",21],[200,"steve",11]];
_scores = [<nowiki/>[123,"bob",15],[123,"bill",20],[200,"dave",21],[200,"steve",11]];
_scores [[sort]] DESC;
_scores [[sort]] DESC;
[[hint]] [[str]] _scores; //<nowiki>[</nowiki>[200,"steve",11],[200,"dave",21],[123,"bob",15],[123,"bill",20]]</code> |EXAMPLE3=
[[hint]] [[str]] _scores; //<nowiki>[</nowiki>[200,"steve",11],[200,"dave",21],[123,"bob",15],[123,"bill",20]]</code>




Line 43: Line 43:
[[getPos]] (_buildings [[select]] 0 [[select]] 1),
[[getPos]] (_buildings [[select]] 0 [[select]] 1),
[[round]] (_buildings [[select]] 0 [[select]] 0)
[[round]] (_buildings [[select]] 0 [[select]] 0)
];</code>|EXAMPLE4=
];</code>




| [[set]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[resize]], [[reverse]], [[count]], [[find]], [[in]], [[forEach]], [[deleteAt]], [[deleteRange]], [[append]], [[toArray]], [[toString]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]], [[BIS_fnc_sortAlphabetically]], [[BIS_fnc_sortBy]], [[BIS_fnc_sortNum]] |SEEALSO=
| [[set]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[resize]], [[reverse]], [[count]], [[find]], [[in]], [[forEach]], [[deleteAt]], [[deleteRange]], [[append]], [[toArray]], [[toString]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]], [[BIS_fnc_sortAlphabetically]], [[BIS_fnc_sortBy]], [[BIS_fnc_sortNum]]


}}
}}

Revision as of 11:24, 18 January 2021

Hover & click on the images for description

Description

Description:
Attempts to sort given array either in ascending (true) or descending (false) order. All array elements should be one of the following types:
  • String - array of strings (["a","b","c"...])
  • Number - array of numbers ([1,2,3...])
  • Array - array of subarrays ([["a",1,2],["b",3,4],["c",5,6]...]). Subarrays should be of the same structure. Subarray elements other than String or Number will be ignored during sorting.
Mixed arrays (["a",1,[true]...]) are not supported and results are undefined.
Groups:
Arrays

Syntax

Syntax:
array sort order
Parameters:
array: Array
order: Boolean - true: ascending, false: descending
Return Value:
Nothing

Examples

Example 1:
_arr = [5.21725,1.30859,4,5.03028,1]; _arr sort true; hint str _arr; //[1,1.30859,4,5.03028,5.21725]
Example 2:
_dev = ["ja","pa","pa","tram","tara"]; _dev sort false; hint str _dev; //["tram","tara","pa","pa","ja"]
Example 3:
#define ASC true #define DESC false _scores = [[123,"bob",15],[123,"bill",20],[200,"dave",21],[200,"steve",11]]; _scores sort DESC; hint str _scores; //[[200,"steve",11],[200,"dave",21],[123,"bob",15],[123,"bill",20]]
Example 4:
Sort buildings by distance and return position of the most distant building:_buildings = player nearObjects ["Land_Cargo_Patrol_V1_F", 500]; _buildings = _buildings apply { [_x distance player, _x] }; _buildings sort false; hint format [ "Most distant building is at %1, distance %2 m", getPos (_buildings select 0 select 1), round (_buildings select 0 select 0) ];

Additional Information

See also:
setpushBackpushBackUniqueapplyselectresizereversecountfindinforEachdeleteAtdeleteRangeappendtoArraytoStringparamparamsarrayIntersectsplitStringjoinStringBIS_fnc_sortAlphabeticallyBIS_fnc_sortByBIS_fnc_sortNum

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 April 16, 2015 - 18:14 (UTC)
Killzone Kid
The algorithm for sorting subarrays: compare 1st element, if equal compare 2nd, if equal compare 3rd...etc.