Rev 11220 | Rev 14279 | 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 |
| 11292 | bpr | 6 | syntax:!shuffle [even|odd] ``n'' |
| 7 | !shuffle [even|odd] ``list'' |
||
| 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\ |
||
| 11210 | bpr | 10 | usage. <br/>\ |
| 11292 | bpr | 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/>\ |
||
| 11210 | bpr | 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/>\ |
||
| 11292 | bpr | 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. |