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

Class SingleThreadSplittableRandomAdapter

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

io.github.pr0methean.betterrandom.prng.adapter.SingleThreadSplittableRandomAdapter

All Implemented Interfaces:

ByteArrayReseedableRandom, EntropyCountingRandom, Java8CompatRandom, RepeatableRandom, Dumpable, Serializable

public class SingleThreadSplittableRandomAdapter
extends DirectSplittableRandomAdapter

Simple, non-thread-safe implementation of BaseRandom that wraps a SplittableRandom.

Author:

Chris Hennick

See Also:

Serialized Form

Field Summary

Fields inherited from class io.github.pr0methean.betterrandom.prng.adapter.DirectSplittableRandomAdapter

delegate

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

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

Constructor Summary

Constructors

Constructor	Description
SingleThreadSplittableRandomAdapter()	Use the DefaultSeedGenerator to create the seed for the SplittableRandom.
SingleThreadSplittableRandomAdapter(byte[] seed)	Use the provided seed for the SplittableRandom.
SingleThreadSplittableRandomAdapter(long seed)	Use the provided seed for the SplittableRandom.
SingleThreadSplittableRandomAdapter(SeedGenerator seedGenerator)	Use the provided seed generation strategy to create the seed for the SplittableRandom.

Method Summary

Modifier and Type	Method	Description
protected void	debitEntropy(long bits)	Must be redeclared in this package so that SplittableRandomAdapter can access it.
protected java8.util.SplittableRandom	getSplittableRandom()	Returns this SingleThreadSplittableRandomAdapter's only SplittableRandom.

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

addSubclassFields, setSeed, setSeedInternal

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

getNewSeedLength, 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, 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

Constructor Detail

SingleThreadSplittableRandomAdapter

public SingleThreadSplittableRandomAdapter(SeedGenerator seedGenerator)
                                    throws SeedException

Use the provided seed generation strategy to create the seed for the SplittableRandom.

Parameters:

seedGenerator - The seed generation strategy that will provide the seed value for this RNG.

Throws:

SeedException - if there is a problem generating a seed.

SingleThreadSplittableRandomAdapter

public SingleThreadSplittableRandomAdapter()
                                    throws SeedException

Use the DefaultSeedGenerator to create the seed for the SplittableRandom.

Throws:

SeedException - if the DefaultSeedGenerator fails to generate a seed.

SingleThreadSplittableRandomAdapter

public SingleThreadSplittableRandomAdapter(byte[] seed)

Use the provided seed for the SplittableRandom.

Parameters:

seed - The seed. Must be 8 bytes.

SingleThreadSplittableRandomAdapter

public SingleThreadSplittableRandomAdapter(long seed)

Use the provided seed for the SplittableRandom.

Parameters:

seed - The seed.

Method Detail

debitEntropy

protected void debitEntropy(long bits)

Must be redeclared in this package so that SplittableRandomAdapter can access it.

Overrides:

debitEntropy in class BaseRandom

Parameters:

bits - The number of bits of entropy spent.

getSplittableRandom

protected java8.util.SplittableRandom getSplittableRandom()

Returns this SingleThreadSplittableRandomAdapter's only SplittableRandom.

Specified by:

getSplittableRandom in class BaseSplittableRandomAdapter

Returns:

the SplittableRandom