c_cpp/etc/calc/help/randombit

   1 NAME
   2     randbit - Blum-Blum-Shub pseudo-random number generator
   3
   4 SYNOPSIS
   5     randombit([x])
   6
   7 TYPES
   8     x           integer
   9
  10     return      integer
  11
  12 DESCRIPTION
  13     If x > 0, randombit(x) returns a pseudo-random integer in [0, 2^x),
  14     i.e. the same as rand(2^x).  If the integer returned is
  15
  16             b_1 * 2^(x-1) + b_2 * 2^(x-2) + ... + b_n,
  17
  18     where each b_i is 0 or 1, then b_1, b_2, ..., b_n may be
  19     considered as a sequence of x random bits.
  20
  21     If x <= 0, randombit(x) causes the random-number generator to skip
  22     abs(x) bits, and returns abs(x).
  23
  24     If x is omitted, it is assumed to have the value of 1.
  25
  26     See the random() help page for details on the additive 55 shuffle
  27     pseudo-random number generator.
  28
  29 EXAMPLE
  30     ; print srandom(0), randombit(20), randombit(20), randombit(20)
  31     RANDOM state 523139 567456 693508
  32     ; print srandom(0), randombit(-20), randombit(20), randombit(-20)
  33     RANDOM state 20 567456 20
  34
  35 LIMITS
  36     x != 0
  37
  38 LINK LIBRARY
  39     void zrandom(long cnt, ZVALUE *res)
  40
  41 SEE ALSO
  42     seed, srand, randbit, isrand, rand, srandom, israndom
  43
  44 ## Copyright (C) 1999  Landon Curt Noll
  45 ##
  46 ## Calc is open software; you can redistribute it and/or modify it under
  47 ## the terms of the version 2.1 of the GNU Lesser General Public License
  48 ## as published by the Free Software Foundation.
  49 ##
  50 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  51 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  52 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  53 ## Public License for more details.
  54 ##
  55 ## A copy of version 2.1 of the GNU Lesser General Public License is
  56 ## distributed with calc under the filename COPYING-LGPL.  You should have
  57 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  58 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  59 ##
  60 ## @(#) $Revision: 30.1 $
  61 ## @(#) $Id: randombit,v 30.1 2007/03/16 11:10:42 chongo Exp $
  62 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/randombit,v $
  63 ##
  64 ## Under source code control:   1997/02/17 01:18:22
  65 ## File existed as early as:    1997
  66 ##
  67 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  68 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/