Rev 11212 | Rev 11292 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
32 | reyssat | 1 | !! +var+ +random+ +string+ |
2 | |||
11210 | bpr | 3 | tit:shuffle |
4 | type:$type_var |
||
11220 | bpr | 5 | alias:randperm, randpermute |
11212 | bpr | 6 | syntax:!shuffle [even|odd] `n' |
7 | !shuffle [even|odd] `list' |
||
11210 | bpr | 8 | mean:Randomly permutes a set of `n' elements. `n' must be a positive integer \ |
9 | not greater than 1024 in the first usage, or is the number of items in `list' in the second\ |
||
10 | usage. <br/>\ |
||
11 | For the first usage, the command returns a comma-separated list `i<sub>1</sub>, i<sub>2</sub>, ...,\ |
||
12 | i<sub>n</sub>', where the items `i<sub>k</sub>' are\ |
||
13 | randomly ordered elements of the set `{1,2,...,n}'. <br/>\ |
||
14 | This command can be used in conjunction with commands\ |
||
15 | $(ref1)cmdlist_item_&+cmd_choose=all$(ref2)cmdlist_item_">!item</a>,\ |
||
16 | $(ref1)cmdlist_line_&+cmd_choose=all$(ref2)cmdlist_line_">!line</a>,\ |
||
17 | $(ref1)cmdlist_word_&+cmd_choose=all$(ref2)cmdlist_word_">!word</a>,\ |
||
18 | $(ref1)cmdlist_char_&+cmd_choose=all$(ref2)cmdlist_char_">!char</a>,\ |
||
19 | to randomly permute items, lines, words, or characters in a string. <br/>\ |
||
20 | For the second usage, a new list with randomly permuted items in `list' is returned. <br/>\ |
||
21 | In any case, the variable `wims_shuffle_order' is set to be\ |
||
22 | the list `i<sub>1</sub>, i<sub>2</sub>, ..., i<sub>n</sub>'. <br/>\ |
||
23 | When the optional word `even' or `odd' is present, only even/odd permutations are produced. |