Package io.github.pr0methean.betterrandom.prng.adapter

Class DirectSplittableRandomAdapter

java.lang.Object

java.util.Random

io.github.pr0methean.betterrandom.prng.BaseRandom

io.github.pr0methean.betterrandom.prng.adapter.BaseSplittableRandomAdapter

io.github.pr0methean.betterrandom.prng.adapter.DirectSplittableRandomAdapter

All Implemented Interfaces:

ByteArrayReseedableRandom, EntropyCountingRandom, Java8CompatRandom, RepeatableRandom, Dumpable, Serializable

Direct Known Subclasses:

SingleThreadSplittableRandomAdapter

public abstract class DirectSplittableRandomAdapter
extends BaseSplittableRandomAdapter

Abstract subclass of BaseSplittableRandomAdapter where setSeed(long) and BaseRandom.setSeed(byte[]) replace the SplittableRandom that's used in the context in which they are called. See SplittableRandomAdapter for an example of when it does not make sense to extend this class.

Author:

Chris Hennick

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected java8.util.SplittableRandom	delegate	The master SplittableRandom that will either be delegated to directly (see SingleThreadSplittableRandomAdapter or be split using SplittableRandom.split() (see SplittableRandomAdapter) and have the splits delegated to.

Fields inherited from class io.github.pr0methean.betterrandom.prng.BaseRandom

ENTROPY_OF_DOUBLE, ENTROPY_OF_FLOAT, entropyBits, lock, randomSeeder, seed, superConstructorFinished

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DirectSplittableRandomAdapter(byte[] seed)	Wraps a SplittableRandom with the specified seed.
protected	DirectSplittableRandomAdapter(long seed)	Wraps a SplittableRandom with the specified seed.

Method Summary

Modifier and Type	Method	Description
protected MoreObjects.ToStringHelper	addSubclassFields(MoreObjects.ToStringHelper original)	Adds the fields that were not inherited from BaseRandom to the given MoreObjects.ToStringHelper for dumping.
void	setSeed(long seed)	Replaces the delegate with a new SplittableRandom that uses the given seed.
protected void	setSeedInternal(byte[] seed)	Replaces the delegate with a new SplittableRandom that uses the given seed.

Methods inherited from class io.github.pr0methean.betterrandom.prng.adapter.BaseSplittableRandomAdapter

getNewSeedLength, getSplittableRandom, lockForNextGaussian, next, nextBoolean, nextBytes, nextDouble, nextDouble, nextDoubleNoEntropyDebit, nextFloat, nextGaussian, nextInt, nextInt, nextInt, nextLong, nextLong, nextLongNoEntropyDebit, preferSeedWithLong, unlockForNextGaussian, withProbabilityInternal

Methods inherited from class io.github.pr0methean.betterrandom.prng.BaseRandom

checkLength, creditEntropyForNewSeed, debitEntropy, doubles, doubles, doubles, doubles, dump, entropyOfInt, entropyOfLong, fallbackSetSeedIfInitialized, gaussians, gaussians, getEntropyBits, getRandomSeeder, getSeed, initTransientFields, internalNextGaussian, ints, ints, ints, ints, longs, longs, longs, longs, needsReseedingEarly, nextDouble, nextElement, nextElement, nextEnum, nextLong, setRandomSeeder, setSeed, supportsMultipleSeedLengths, usesParallelStreams, withProbability

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

delegate

protected transient volatile java8.util.SplittableRandom delegate

The master SplittableRandom that will either be delegated to directly (see SingleThreadSplittableRandomAdapter or be split using SplittableRandom.split() (see SplittableRandomAdapter) and have the splits delegated to.

Constructor Detail

DirectSplittableRandomAdapter

protected DirectSplittableRandomAdapter(byte[] seed)

Wraps a SplittableRandom with the specified seed.

Parameters:

seed - 8 bytes of seed data used to initialize the RNG.

DirectSplittableRandomAdapter

protected DirectSplittableRandomAdapter(long seed)

Wraps a SplittableRandom with the specified seed.

Parameters:

seed - the seed.

Method Detail

addSubclassFields

protected MoreObjects.ToStringHelper addSubclassFields(MoreObjects.ToStringHelper original)

Description copied from class: BaseRandom

Adds the fields that were not inherited from BaseRandom to the given MoreObjects.ToStringHelper for dumping.

Specified by:

addSubclassFields in class BaseRandom

Parameters:

original - a MoreObjects.ToStringHelper object.

Returns:

original with the fields not inherited from BaseRandom written to it.

setSeedInternal

protected void setSeedInternal(byte[] seed)

Replaces the delegate with a new SplittableRandom that uses the given seed.

Overrides:

setSeedInternal in class BaseRandom

Parameters:

seed - the new seed; must be 8 bytes

setSeed

public void setSeed(long seed)

Replaces the delegate with a new SplittableRandom that uses the given seed.

Specified by:

setSeed in interface Java8CompatRandom

Overrides:

setSeed in class BaseRandom

Parameters:

seed - the new seed