Rev 14279 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
| Rev 14279 | Rev 17228 | ||
|---|---|---|---|
| Line 6... | Line 6... | ||
| 6 | syntax:!shuffle [even|odd] ``n''\ |
6 | syntax:!shuffle [even|odd] ``n''\ |
| 7 | !shuffle [even|odd] ``list'' |
7 | !shuffle [even|odd] ``list'' |
| 8 | 8 | ||
| 9 | mean:Randomly permutes a set of ``n'' elements. ``n'' must be a positive integer\ |
9 | mean:Randomly permutes a set of ``n'' elements. ``n'' must be a positive integer\ |
| 10 | not greater than 1024 in the first usage, or is the number of items in ``list'' in the second\ |
10 | not greater than 1024 in the first usage, or is the number of items in ``list'' in the second\ |
| 11 | usage. <br |
11 | usage. <br>\ |
| 12 | For the first usage, the command returns a comma-separated list ``i<sub>1</sub>, i<sub>2</sub>, ...,\ |
12 | For the first usage, the command returns a comma-separated list ``i<sub>1</sub>, i<sub>2</sub>, ...,\ |
| 13 | i<sub>n</sub>'', where the items ``i<sub>k</sub>'' are\ |
13 | i<sub>n</sub>'', where the items ``i<sub>k</sub>'' are\ |
| 14 | randomly ordered elements of the set ``{1,2,...,n}''. <br |
14 | randomly ordered elements of the set ``{1,2,...,n}''. <br>\ |
| 15 | This command can be used in conjunction with commands\ |
15 | This command can be used in conjunction with commands\ |
| 16 | $(ref1)cmdlist_item_&+cmd_choose=all$(ref2)cmdlist_item_">!item</a>,\ |
16 | $(ref1)cmdlist_item_&+cmd_choose=all$(ref2)cmdlist_item_">!item</a>,\ |
| 17 | $(ref1)cmdlist_line_&+cmd_choose=all$(ref2)cmdlist_line_">!line</a>,\ |
17 | $(ref1)cmdlist_line_&+cmd_choose=all$(ref2)cmdlist_line_">!line</a>,\ |
| 18 | $(ref1)cmdlist_word_&+cmd_choose=all$(ref2)cmdlist_word_">!word</a>,\ |
18 | $(ref1)cmdlist_word_&+cmd_choose=all$(ref2)cmdlist_word_">!word</a>,\ |
| 19 | $(ref1)cmdlist_char_&+cmd_choose=all$(ref2)cmdlist_char_">!char</a>,\ |
19 | $(ref1)cmdlist_char_&+cmd_choose=all$(ref2)cmdlist_char_">!char</a>,\ |
| 20 | to randomly permute items, lines, words, or characters in a string. <br |
20 | to randomly permute items, lines, words, or characters in a string. <br>\ |
| 21 | For the second usage, a new list with randomly permuted items in ``list'' is returned. <br |
21 | For the second usage, a new list with randomly permuted items in ``list'' is returned. <br>\ |
| 22 | In any case, the variable ``wims_shuffle_order'' is set to be\ |
22 | In any case, the variable ``wims_shuffle_order'' is set to be\ |
| 23 | the list ``i<sub>1</sub>, i<sub>2</sub>, ..., i<sub>n</sub>''. <br |
23 | the list ``i<sub>1</sub>, i<sub>2</sub>, ..., i<sub>n</sub>''. <br>\ |
| 24 | When the optional word ``even'' or ``odd'' is present, only even/odd permutations are produced. |
24 | When the optional word ``even'' or ``odd'' is present, only even/odd permutations are produced. |