Subversion Repositories wimsdev

Rev

Rev 14279 | 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.  
  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\
  11.   usage. <br>\
  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\
  14.   randomly ordered elements of the set ``{1,2,...,n}''. <br>\
  15.   This command can be used in conjunction with commands\
  16.   $(ref1)cmdlist_item_&+cmd_choose=all$(ref2)cmdlist_item_">!item</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>,\
  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>\
  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\
  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.
  25.