Difference between revisions of "LlListRandomize"

Revision as of 18:14, 29 May 2008

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.

<lsl> list dice = ["2", "4", "1", "6", "3", "5"];

default {

   touch_start(integer num_detected) {
       list shuffled = llListRandomize(dice, 1);
       llOwnerSay(llList2CSV(shuffled));
   }

}

</lsl>

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

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

@@ Line 19: / Line 19: @@
 |examples=
 <lsl>
+list dice = ["2", "4", "1", "6", "3", "5"];
 default
 {
      touch_start(integer num_detected) {
-        list dice = ["2", "4", "1", "6", "3", "5"];
          list shuffled = llListRandomize(dice, 1);
          llOwnerSay(llList2CSV(shuffled));