com.googlecode.jinahya.util

Class JinahyaRandom

java.lang.Object

com.googlecode.jinahya.util.JinahyaRandom

All Implemented Interfaces:

Serializable

public class JinahyaRandom
extends Object
implements Serializable

Author:

Jin Kwon

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
JinahyaRandom(Random random) Creates a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	nextBytes(int minimumLength, int maximumLength) Generates a random byte array.
static byte[]	nextBytes(Random random, int minimumLength, int maximumLength) Generates a random byte array.
protected int	nextInt(int minimum, int maximum) Returns a pseudorandom, uniformly distributed int value between minimum (inclusive) and maximum (exclusive), drawn from the wrapped random number generator's sequence.
static int	nextInt(Random random, int minimum, int maximum) Returns a pseudorandom, uniformly distributed int value between minimum (inclusive) and maximum (exclusive), drawn from the given random number generator's sequence.
int	nextSignedInt(int minimumBitLength, int maximumBitLength) Generates a signed integer in arbitrary bit length.
long	nextSignedLong(int minimumBitLength, int maximumBitLength) Generates a signed long in arbitrary bit length.
int	nextUnsignedInt(int minimumBitLength, int maximumBitLength) Generates an unsigned integer in arbitrary bit length.
long	nextUnsignedLong(int minimumBitLength, int maximumBitLength) Generates an unsigned long in arbitrary bits.

Methods inherited from class java.lang.Object

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

Constructor Detail

JinahyaRandom

public JinahyaRandom(Random random)

Creates a new instance.

Parameters:

random - the random to be wrapped.

Method Detail

nextInt

public static int nextInt(Random random,
          int minimum,
          int maximum)

Returns a pseudorandom, uniformly distributed int value between minimum (inclusive) and maximum (exclusive), drawn from the given random number generator's sequence. An instance of IllegalArgumentException will thrown if the range is greater than .

Parameters:

random - random

minimum - the lower bound on the random number to returned

maximum - the upper bound on the random number to returned; must be greater than or equal to minimum.

Returns:

the next pseudorandom, uniformly distributed int value between minimum (inclusive) and maximum (exclusive) from the wrapped random number generator's sequence.

nextBytes

public static byte[] nextBytes(Random random,
               int minimumLength,
               int maximumLength)

Generates a random byte array. The length of result byte array is between minimumLength (inclusive) and maximumLength (exclusive).

Parameters:

random - random

minimumLength - minimum array length; must be greater than or equal to 0.

maximumLength - maximum array length; must be greater than or equal to minimumLength.

Returns:

the generated byte array

nextInt

protected int nextInt(int minimum,
          int maximum)

Returns a pseudorandom, uniformly distributed int value between minimum (inclusive) and maximum (exclusive), drawn from the wrapped random number generator's sequence. An instance of IllegalArgumentException will thrown if the range is greater than .

Parameters:

minimum - the lower bound on the random number to returned

maximum - the upper bound on the random number to returned; must be greater than or equal to minimum.

Returns:

the next pseudorandom, uniformly distributed int value between minimum (inclusive) and maximum (exclusive) from the wrapped random number generator's sequence.

nextBytes

public byte[] nextBytes(int minimumLength,
               int maximumLength)

Generates a random byte array. The length of result byte array is between minimumLength (inclusive) and maximumLength (exclusive).

Parameters:

minimumLength - minimum array length; must be greater than or equal to 0.

maximumLength - maximum array length; must be greater than or equal to minimumLength.

Returns:

the generated byte array

nextUnsignedInt

public int nextUnsignedInt(int minimumBitLength,
                  int maximumBitLength)

Generates an unsigned integer in arbitrary bit length. 1 <= minimumBitLength <= maximumBitLength <= 32.

Parameters:

minimumBitLength - the minimum number of bits; must be greater than or equal to 1.

maximumBitLength - the maximum number of bits; must be between minimumBitLength (inclusive) and 32 (exclusive).

Returns:

the generated value.

nextSignedInt

public int nextSignedInt(int minimumBitLength,
                int maximumBitLength)

Generates a signed integer in arbitrary bit length. 1 <= minimumBitLength <= maximumBitLength < 32.

Parameters:

minimumBitLength - the minimum number of bits; must be greater than 1.

maximumBitLength - the maximum number of bits; must be between minimumBitLength (inclusive) and 32 (inclusive).

Returns:

the generated value.

nextUnsignedLong

public long nextUnsignedLong(int minimumBitLength,
                    int maximumBitLength)

Generates an unsigned long in arbitrary bits. 1 <= minimumBitLength <= maximumBitLength < 64.

Parameters:

minimumBitLength - the minimum number of bits; must be greater than or equal to 1.

maximumBitLength - the maximum number of bits; must be between minimumBitLength (inclusive) and 64 (exclusive).

Returns:

the generated value.

nextSignedLong

public long nextSignedLong(int minimumBitLength,
                  int maximumBitLength)

Generates a signed long in arbitrary bit length. 1 < minimumBitLength <= maximumBitLength <= 64.

Parameters:

minimumBitLength - the minimum number of bits; must be greater than 1.

maximumBitLength - the maximum number of bits; must be between minimumBitLength (inclusive) and 64 (inclusive).

Returns:

generated value.