Subversion Repositories wimsdev

Rev

Rev 11220 | Rev 14279 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

  1. !! +var+ +random+ +string+
  2.  
  3. tit:shuffle
  4. type:$type_var
  5. alias:randperm, randpermute
  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\
  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.
  24.