Difference between revisions of "LlListRandomize"
m |
|||
| Line 11: | Line 11: | ||
|return_text=which is a randomized permutation of '''src'''. | |return_text=which is a randomized permutation of '''src'''. | ||
|spec= | |spec= | ||
When you want to randomize the position of every list element, specify a stride of 1. | This function supports [[List#Strided_lists|Strided Lists]]. | ||
When you want to randomize the position of every list element, specify a stride of 1. This is perhaps the setting most used. | |||
If the stride is not a factor of the list length, the '''src''' list is returned. In other words, src.length() % stride must be 0. | If the stride is not a factor of the list length, the '''src''' list is returned. In other words, src.length() % stride must be 0. | ||
Conceptually, the algorithm selects src.length()/stride buckets, and then for each bucket swaps | Conceptually, the algorithm selects src.length()/stride buckets, and then for each bucket swaps in the contents with another bucket. | ||
|caveats= | |caveats= | ||
|examples= | |examples= | ||
| Line 29: | Line 31: | ||
} | } | ||
</lsl> | </lsl> | ||
list list01 = ["Cold", "pizza", "in", "the", "early", "morning"]; | |||
<lsl> | |||
list list_random = llListRandomize(list01, 2); | |||
</lsl> | |||
This could return: | |||
1) "Cold", "pizza", "in", "the", "early", "morning"<br /> | |||
2) "Cold", "pizza", "early", "morning", "in", "the"<br /> | |||
3) "in", "the", "Cold", "pizza", "early", "morning"<br /> | |||
4) "in", "the", "early", "morning", "Cold", "pizza"<br /> | |||
5) "early", "morning", "Cold", "pizza", "in", "the"<br /> | |||
6) "early", "morning", "in", "the", "Cold", "pizza"<br /> | |||
Notice that two adjacent elements from the original list are always kept together, because the stride of 2 was specified. | |||
<lsl> | |||
list list_random = llListRandomize(list01, 6); | |||
</lsl> | |||
Returns the original list, exactly in the order it already was, because we told it to keep every set of six elements together, and there are only six elements in the list. | |||
|constants | |constants | ||
|helpers | |helpers | ||
Revision as of 12:20, 13 July 2008
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: list llListRandomize( list src, integer stride );| 197 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a list which is a randomized permutation of src.
| • list | src | – | A list you want to randomize. | |
| • integer | stride | – | How many list entries to keep next to each other during the randomization. |
Specification
This function supports Strided Lists.
When you want to randomize the position of every list element, specify a stride of 1. This is perhaps the setting most used.
If the stride is not a factor of the list length, the src list is returned. In other words, src.length() % stride must be 0.
Conceptually, the algorithm selects src.length()/stride buckets, and then for each bucket swaps in the contents with another bucket.
Caveats
Examples
<lsl> list dice = ["2", "4", "1", "6", "3", "5"];
default {
touch_start(integer num_detected) {
list shuffled = llListRandomize(dice, 1);
llOwnerSay(llList2CSV(shuffled));
}
} </lsl>
list list01 = ["Cold", "pizza", "in", "the", "early", "morning"];
<lsl> list list_random = llListRandomize(list01, 2); </lsl>
This could return:
1) "Cold", "pizza", "in", "the", "early", "morning"
2) "Cold", "pizza", "early", "morning", "in", "the"
3) "in", "the", "Cold", "pizza", "early", "morning"
4) "in", "the", "early", "morning", "Cold", "pizza"
5) "early", "morning", "Cold", "pizza", "in", "the"
6) "early", "morning", "in", "the", "Cold", "pizza"
Notice that two adjacent elements from the original list are always kept together, because the stride of 2 was specified.
<lsl> list list_random = llListRandomize(list01, 6); </lsl>
Returns the original list, exactly in the order it already was, because we told it to keep every set of six elements together, and there are only six elements in the list.See Also
Functions
| • | llListSort | |||
| • | llFrand |
Deep Notes
Source
lsa_randomize(): 'linden\indra\lscript\lscript_library\lscript_alloc.cpp'
Signature |
|---|
function list llListRandomize( list src, integer stride ); |