org.jenetics.util

Class Random64

java.lang.Object

java.util.Random

org.jenetics.util.Random64

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

LCG64ShiftRandom

public abstract class Random64
extends Random

An abstract base class which eases the implementation of Random objects which natively creates random long values. All other Random functions are optimized using this long values.

public class MyRandom64 extends Random64 { @Override public long nextLong() { // Only this method must be implemented. ... } }

Since:

1.1

Version:

2.0

Author:

Franz Wilhelmstötter

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Random64()
protected	Random64(long seed)

Method Summary

Modifier and Type	Method and Description
protected int	next(int bits)
boolean	nextBoolean()
void	nextBytes(byte[] bytes) Optimized version of the Random.nextBytes(byte[]) method for 64-bit random engines.
double	nextDouble() Optimized version of the Random.nextDouble() method for 64-bit random engines.
double	nextDouble(double min, double max) Returns a pseudorandom, uniformly distributed double value between min (inclusively) and max (exclusively).
float	nextFloat()
float	nextFloat(float min, float max) Returns a pseudorandom, uniformly distributed double value between min (inclusively) and max (exclusively).
int	nextInt()
int	nextInt(int min, int max) Returns a pseudorandom, uniformly distributed int value between min and max (end points included).
abstract long	nextLong() Force to explicitly override the Random.nextLong() method.
long	nextLong(long n) Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), drawn from the given random number generator's sequence.
long	nextLong(long min, long max) Returns a pseudorandom, uniformly distributed int value between min and max (end points included).
static Random64	of(LongSupplier supplier) Create a new Random64 instance, where the random numbers are generated by the given long supplier.

Methods inherited from class java.util.Random

doubles, doubles, doubles, doubles, ints, ints, ints, ints, longs, longs, longs, longs, nextGaussian, nextInt, setSeed

Methods inherited from class java.lang.Object

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

Constructor Detail

Random64

protected Random64(long seed)

Random64

protected Random64()

Method Detail

nextLong

public abstract long nextLong()

Force to explicitly override the Random.nextLong() method. All other methods of this class are implemented by calling this method.

Overrides:

nextLong in class Random

nextBoolean

public boolean nextBoolean()

Overrides:

nextBoolean in class Random

nextInt

public int nextInt()

Overrides:

nextInt in class Random

next

protected int next(int bits)

Overrides:

next in class Random

nextBytes

public void nextBytes(byte[] bytes)

Optimized version of the Random.nextBytes(byte[]) method for 64-bit random engines.

Overrides:

nextBytes in class Random

nextFloat

public float nextFloat()

Overrides:

nextFloat in class Random

nextDouble

public double nextDouble()

Optimized version of the Random.nextDouble() method for 64-bit random engines.

Overrides:

nextDouble in class Random

of

public static Random64 of(LongSupplier supplier)

Create a new Random64 instance, where the random numbers are generated by the given long supplier.

Parameters:

supplier - the random number supplier

Returns:

a new Random64 instance

Throws:

NullPointerException - if the given supplier is null.

nextInt

public int nextInt(int min,
                   int max)

Returns a pseudorandom, uniformly distributed int value between min and max (end points included).

Parameters:

min - lower bound for generated integer (inclusively)

max - upper bound for generated integer (inclusively)

Returns:

a random integer greater than or equal to min and less than or equal to max

Throws:

IllegalArgumentException - if min >= max

See Also:

random.nextInt(java.util.Random, int, int)

nextLong

public long nextLong(long min,
                     long max)

Returns a pseudorandom, uniformly distributed int value between min and max (end points included).

Parameters:

min - lower bound for generated long integer (inclusively)

max - upper bound for generated long integer (inclusively)

Returns:

a random long integer greater than or equal to min and less than or equal to max

Throws:

IllegalArgumentException - if min >= max

See Also:

random.nextLong(java.util.Random, long, long)

nextLong

public long nextLong(long n)

Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), drawn from the given random number generator's sequence.

Parameters:

n - the bound on the random number to be returned. Must be positive.

Returns:

the next pseudorandom, uniformly distributed int value between 0 (inclusive) and n (exclusive) from the given random number generator's sequence

Throws:

IllegalArgumentException - if n is smaller than 1.

See Also:

random.nextLong(java.util.Random, long)

nextFloat

public float nextFloat(float min,
                       float max)

Returns a pseudorandom, uniformly distributed double value between min (inclusively) and max (exclusively).

Parameters:

min - lower bound for generated float value (inclusively)

max - upper bound for generated float value (exclusively)

Returns:

a random float greater than or equal to min and less than to max

See Also:

random.nextFloat(java.util.Random, float, float)

nextDouble

public double nextDouble(double min,
                         double max)

Returns a pseudorandom, uniformly distributed double value between min (inclusively) and max (exclusively).

Parameters:

min - lower bound for generated double value (inclusively)

max - upper bound for generated double value (exclusively)

Returns:

a random double greater than or equal to min and less than to max

See Also:

random.nextDouble(java.util.Random, double, double)