c_cpp/etc/calc/help/randperm

   1 NAME
   2     randperm - randomly permute a list or matrix
   3
   4 SYNOPSIS
   5     randperm(x)
   6
   7 TYPES
   8     x           list or matrix
   9
  10     return      same as x
  11
  12 DESCRIPTION
  13     For a list or matrix x, randperm(x) returns a copy of x in which
  14     the elements have been randomly permuted.  The value of x is not
  15     changed.
  16
  17     This function uses the rand() subtractive 100 shuffle pseudo-random
  18     number generator.
  19
  20 EXAMPLE
  21     ; A = list(1,2,2,3,4)
  22     ; randperm(A)
  23
  24     list (5 elements, 5 nonzero):
  25           [[0]] = 4
  26           [[1]] = 1
  27           [[2]] = 2
  28           [[3]] = 3
  29           [[4]] = 2
  30
  31     ; randperm(A)
  32
  33     list (5 elements, 5 nonzero):
  34           [[0]] = 2
  35           [[1]] = 1
  36           [[2]] = 4
  37           [[3]] = 2
  38           [[4]] = 3
  39
  40 LIMITS
  41     none
  42
  43 LINK LIBRARY
  44     none
  45
  46 SEE ALSO
  47     comp, fact, rand, perm
  48
  49 ## Copyright (C) 1999-2006  Landon Curt Noll
  50 ##
  51 ## Calc is open software; you can redistribute it and/or modify it under
  52 ## the terms of the version 2.1 of the GNU Lesser General Public License
  53 ## as published by the Free Software Foundation.
  54 ##
  55 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  56 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  57 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  58 ## Public License for more details.
  59 ##
  60 ## A copy of version 2.1 of the GNU Lesser General Public License is
  61 ## distributed with calc under the filename COPYING-LGPL.  You should have
  62 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  63 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  64 ##
  65 ## @(#) $Revision: 30.1 $
  66 ## @(#) $Id: randperm,v 30.1 2007/03/16 11:10:42 chongo Exp $
  67 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/randperm,v $
  68 ##
  69 ## Under source code control:   1995/07/10 02:09:31
  70 ## File existed as early as:    1995
  71 ##
  72 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  73 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/