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