BIS fnc selectRandomWeighted: Difference between revisions

Latest revision as of 16:41, 13 July 2022

1.00

1.50

1.00

0.50

Hover & click on the images for description

Description

Description:

Selects a random item from an array, taking into account item weight.

ⓘ

The weights do not have to total to 1
The length of weights and items arrays may not match, in which case the shortest array is used for length

See selectRandomWeighted for an engine solution.

Execution:

call

Groups:

Arrays

Syntax

Syntax:: itemsAndWeights call BIS_fnc_selectRandomWeighted
Parameters:: itemsAndWeights: Array - array of items and weights [item, weight, item, weight...]
Return Value:: Anything

Alternative Syntax

Syntax:: [items, weights] call BIS_fnc_selectRandomWeighted
Parameters:: items: Array - items array of Anything
: weights: Array - weights array of Numbers
Return Value:: Anything

Examples

Example 1:: ["apples",.3,"pears",.2,"bananas",.4,"diamonds",.1,"unicorns",.00001] call BIS_fnc_selectRandomWeighted;
Example 2:: [["apples","pears","bananas","diamonds"], [0.3,0.2,0.4,0.1]] call BIS_fnc_selectRandomWeighted;

Additional Information

See also:: selectRandomWeighted

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

@@ Line 1: / Line 1: @@
+{{RV|type=function
-{{Function|= Comments
+|game1= arma2
-____________________________________________________________________________________________
+|version1= 1.00
-| arma2 |= Game name
+|game2= arma2oa
+|version2= 1.50
-|1.00|= Game version
+|game3= tkoh
-____________________________________________________________________________________________
+|version3= 1.00
-| Selects a random item from an array, taking into account item weight. Note:
+|game4= arma3
-* The weights don't have to total to 1
+|version4= 0.50
-* The length of weights and items arrays may not match, in which case the shortest array is used for length|DESCRIPTION=
-____________________________________________________________________________________________
-| itemsAndWeights call [[BIS_fnc_selectRandomWeighted]] |SYNTAX=
+|gr1= Arrays
-|p1=itemsAndWeights: [[Array]] - array of items and weights [item, weight, item, weight...]|PARAMETER1=
+|descr= Selects a random item from an array, taking into account item weight.
+{{Feature|informative|
+* The weights do not have to total to 1
+* The length of weights and items arrays may not match, in which case the shortest array is used for length
+}}
-| [[Anything]] |RETURNVALUE=
+{{Feature|arma3|See [[selectRandomWeighted]] for an engine solution.}}
-|s2= [items, weights] call [[BIS_fnc_selectRandomWeighted]] |SYNTAX=
+|s1= itemsAndWeights call [[BIS_fnc_selectRandomWeighted]]
-|p21=[items, weights]: [[Array]]|PARAMETER1=
-|p22=items: [[Array]] - items array of [[Anything]] |PARAMETER1=
-|p23=weights: [[Array]] - weights array of [[Number]]s |PARAMETER1=
-|r2= [[Anything]] |RETURNVALUE=
+|p1= itemsAndWeights: [[Array]] - array of items and weights [item, weight, item, weight...]
-____________________________________________________________________________________________
-|x1= <code>["apples",.3,"pears",.2,"bananas",.4,"diamonds",.1,"unicorns",.00001] [[call]] [[BIS_fnc_selectRandomWeighted]];</code> |=
-|x2= <code><nowiki>[</nowiki>["apples","pears","bananas","diamonds"],[0.3,0.2,0.4,0.1]] [[call]] [[BIS_fnc_selectRandomWeighted]];</code> |=
-____________________________________________________________________________________________
-| [[selectRandomWeighted]]|SEEALSO=
+|r1= [[Anything]]
-}}
+|s2= [items, weights] call [[BIS_fnc_selectRandomWeighted]]
+|p21= items: [[Array]] - items array of [[Anything]]
+|p22= weights: [[Array]] - weights array of [[Number]]s
+|r2= [[Anything]]
-<h3 style="display:none">Notes</h3>
+|x1= <sqf>["apples",.3,"pears",.2,"bananas",.4,"diamonds",.1,"unicorns",.00001] call BIS_fnc_selectRandomWeighted;</sqf>
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
+|x2= <sqf>[["apples","pears","bananas","diamonds"], [0.3,0.2,0.4,0.1]] call BIS_fnc_selectRandomWeighted;</sqf>
-</dl>
-<h3 style="display:none">Bottom Section</h3>
+|seealso= [[selectRandomWeighted]]
-[[Category:Function Group: Arrays|{{uc:selectRandomWeighted}}]]
+}}
-[[Category:Functions|{{uc:selectRandomWeighted}}]]
-[[Category:{{Name|arma2}}: Functions|{{uc:selectRandomWeighted}}]]
-[[Category:{{Name|arma2oa}}: Functions|{{uc:selectRandomWeighted}}]]
-[[Category:{{Name|tkoh}}: Functions|{{uc:selectRandomWeighted}}]]
-[[Category:{{Name|arma3}}: Functions|{{uc:selectRandomWeighted}}]]