1.76

Hover & click on the images for description

Description

Description:

Returns a random element from the given array according to assigned weights. Engine solution to BIS_fnc_selectRandomWeighted. A few notes:

• Negative weights are not supported
• If an item's weight is 0, the item is ignored
• The weights don't have to total to 1
• If numbers of items and weights do not match, the shortest array is used
• A single array Syntax is slightly faster than Alt Syntax

Groups:

Arrays

Syntax

Syntax:

selectRandomWeighted valuesAndWeights

Parameters:

valuesAndWeights: Array - array in format [value1, weight1, value2, weight2, ...], where:

• value: Anything - weighted value
• weight: Number - values relative weight

Return Value:

Anything - random weighted value or Nothing if array is empty or all weights are 0

Syntax:

values selectRandomWeighted weights

Parameters:

values: Array of Anything

weights: Array of Numbers

Return Value:

Anything - random weighted value or Nothing if any of arrays is empty or all weights are 0

Examples

Example 1:

Copy

private _randomWeightedElement = selectRandomWeighted [1,0.1,2,0.2,3,1.3,4,2.4,5,7.5];

Example 2:

Copy

private _randomWeightedElement = [1,2,3,4,5] selectRandomWeighted [0.1,0.2,1.3,2.4,7.5];

Additional Information

See also:

random select selectRandom selectMin selectMax

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