Difference between revisions of "LlListRandomize"

Revision as of 06:44, 2 October 2007

Function: list llListRandomize( list src, integer stride );


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.

When you want to randomize the position of every list element, specify a stride of 1.

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 it the contents with another bucket.

list dice = ["2", "4", "1", "6", "3", "5"];
list shuffled = llListRandomize(dice, 1);
llOwnerSay(llList2CSV(shuffled));

lsa_randomize(): 'linden\indra\lscript\lscript_library\lscript_alloc.cpp'

Signature
function list llListRandomize( list src, integer stride );

@@ Line 19: / Line 19: @@
 |examples=
 <pre>
-list straws = ["long", "long", "long", "short"];
+list dice = ["2", "4", "1", "6", "3", "5"];
-list shuffled = llListRandomize(straws, 1);
+list shuffled = llListRandomize(dice, 1);
-llSay(0, llList2CSV(bar));
+llOwnerSay(llList2CSV(shuffled));
 </pre>
 |constants