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