Subversion Repositories wimsdev

Rev

Rev 11212 | Rev 11292 | 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.