HELPLIB.HLB  —  CRTL  initstate
    Initializes random-number generators.

    Format

      #include  <stdlib.h>

      char *initstate  (unsigned int seed, char *state, int size);

1  –  Arguments

 seed

    An initial seed value.

 state

    Pointer to an array of state information.

 size

    The size of the state information array.

2  –  Description

    The initstate function initializes random-number generators. It
    lets you initialize, for future use, a state array passed as an
    argument. The size, in bytes, of the state array is used by the
    initstate function to decide how sophisticated a random-number
    generator to use; the larger the state array, the more random the
    numbers.

    Values for the amount of state information are 8, 32, 64, 128,
    and 256 bytes. Amounts less than 8 bytes generate an error, while
    other amounts are rounded down to the nearest known value.

    The seed argument specifies a starting point for the random-
    number sequence and provides for restarting at the same point.
    The initstate function returns a pointer to the previous state
    information array.

    Once you initialize a state, the setstate function allows rapid
    switching between states. The array defined by the state argument
    is used for further random-number generation until the initstate
    function is called or the setstate function is called again. The
    setstate function returns a pointer to the previous state array.

    After initialization, you can restart a state array at a
    different point in one of two ways:

    o  Use the initstate function with the desired seed argument,
       state array, and size of the array.

    o  Use the setstate function with the desired state, followed by
       the srandom function with the desired seed. The advantage of
       using both functions is that you do not have to save the state
       array size once you initialize it.

    See also setstate, srandom, and random.

3  –  Return Values

    x                  A pointer to the previous state array
                       information.
    0                  Indicates an error. Call made with less than 8
                       bytes of state information. Further specified
                       in the global errno.
Close Help