c_cpp/etc/calc/help/randbit

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