Class BasePRNG

protected byte[] buffer

A temporary buffer to serve random bytes.

protected boolean initialised

Indicate if this instance has already been initialised or not.

protected String name

The canonical name prefix of the PRNG algorithm.

protected int ndx

The index into buffer of where the next byte will come from.

protected BasePRNG(String name)

Trivial constructor for use by concrete subclasses.

Parameters:

name - the canonical name of this instance.

public void addRandomByte(byte b)

Specified by:

addRandomByte in interface IRandom

public void addRandomBytes(byte[] buffer)

Specified by:

addRandomBytes in interface IRandom

public void addRandomBytes(byte[] buffer,
                           int offset,
                           int length)

Specified by:

addRandomBytes in interface IRandom

public Object clone()
            throws CloneNotSupportedException

This method may be called to create a new copy of the Object. The typical behavior is as follows:

• o == o.clone() is false
• o.getClass() == o.clone().getClass() is true
• o.equals(o) is true

However, these are not strict requirements, and may be violated if necessary. Of the three requirements, the last is the most commonly violated, particularly if the subclass does not override Object.equals(Object).

If the Object you call clone() on does not implement Cloneable (which is a placeholder interface), then a CloneNotSupportedException is thrown. Notice that Object does not implement Cloneable; this method exists as a convenience for subclasses that do.

Object's implementation of clone allocates space for the new Object using the correct class, without calling any constructors, and then fills in all of the new field values with the old field values. Thus, it is a shallow copy. However, subclasses are permitted to make a deep copy.

All array types implement Cloneable, and override this method as follows (it should never fail):

 public Object clone()
 {
   try
     {
       super.clone();
     }
   catch (CloneNotSupportedException e)
     {
       throw new InternalError(e.getMessage());
     }
 }
 

Specified by:

clone in interface IRandom

Overrides:

clone in interface Object

Returns:

a copy of the Object

Throws:

CloneNotSupportedException - If this Object does not implement Cloneable

See Also:

Cloneable

public abstract void fillBlock()
            throws LimitReachedException

public void init(Map<K,V> attributes)

Specified by:

init in interface IRandom

public boolean isInitialised()

public String name()

Specified by:

name in interface IRandom

public byte nextByte()
            throws IllegalStateException,
                   LimitReachedException

Specified by:

nextByte in interface IRandom

public void nextBytes(byte[] out)
            throws IllegalStateException,
                   LimitReachedException

public void nextBytes(byte[] out,
                      int offset,
                      int length)
            throws IllegalStateException,
                   LimitReachedException

Specified by:

nextBytes in interface IRandom

public abstract void setup(Map<K,V> attributes)