org.apache.commons.lang.math
Class RandomUtils

java.lang.Object
  extended by org.apache.commons.lang.math.RandomUtils

public class RandomUtils
extends Object

RandomUtils is a wrapper that supports all possible Random methods via the Math.random() method and its system-wide Random object.

Since:
2.0
Version:
$Id: RandomUtils.java 906320 2010-02-04 01:41:10Z sebb $
Author:
Gary D. Gregory

Field Summary
static Random JVM_RANDOM
          An instance of JVMRandom.
 
Constructor Summary
RandomUtils()
           
 
Method Summary
static boolean nextBoolean()
          Returns the next pseudorandom, uniformly distributed boolean value from the Math.random() sequence.
static boolean nextBoolean(Random random)
          Returns the next pseudorandom, uniformly distributed boolean value from the given random sequence.
static double nextDouble()
          Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the Math.random() sequence.
static double nextDouble(Random random)
          Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the given Random sequence.
static float nextFloat()
          Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the Math.random() sequence.
static float nextFloat(Random random)
          Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the given Random sequence.
static int nextInt()
          Returns the next pseudorandom, uniformly distributed int value from the Math.random() sequence.
static int nextInt(int n)
          Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), from the Math.random() sequence.
static int nextInt(Random random)
          Returns the next pseudorandom, uniformly distributed int value from the given random sequence.
static int nextInt(Random random, int n)
          Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), from the given Random sequence.
static long nextLong()
          Returns the next pseudorandom, uniformly distributed long value from the Math.random() sequence.
static long nextLong(Random random)
          Returns the next pseudorandom, uniformly distributed long value from the given Random sequence.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

JVM_RANDOM

public static final Random JVM_RANDOM
An instance of JVMRandom.

Constructor Detail

RandomUtils

public RandomUtils()
Method Detail

nextInt

public static int nextInt()

Returns the next pseudorandom, uniformly distributed int value from the Math.random() sequence.

N.B. All values are >= 0.

Returns:
the random int

nextInt

public static int nextInt(Random random)

Returns the next pseudorandom, uniformly distributed int value from the given random sequence.

Parameters:
random - the Random sequence generator.
Returns:
the random int

nextInt

public static int nextInt(int n)

Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), from the Math.random() sequence.

Parameters:
n - the specified exclusive max-value
Returns:
the random int

nextInt

public static int nextInt(Random random,
                          int n)

Returns a pseudorandom, uniformly distributed int value between 0 (inclusive) and the specified value (exclusive), from the given Random sequence.

Parameters:
random - the Random sequence generator.
n - the specified exclusive max-value
Returns:
the random int

nextLong

public static long nextLong()

Returns the next pseudorandom, uniformly distributed long value from the Math.random() sequence.

N.B. All values are >= 0.

Returns:
the random long

nextLong

public static long nextLong(Random random)

Returns the next pseudorandom, uniformly distributed long value from the given Random sequence.

Parameters:
random - the Random sequence generator.
Returns:
the random long

nextBoolean

public static boolean nextBoolean()

Returns the next pseudorandom, uniformly distributed boolean value from the Math.random() sequence.

Returns:
the random boolean

nextBoolean

public static boolean nextBoolean(Random random)

Returns the next pseudorandom, uniformly distributed boolean value from the given random sequence.

Parameters:
random - the Random sequence generator.
Returns:
the random boolean

nextFloat

public static float nextFloat()

Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the Math.random() sequence.

Returns:
the random float

nextFloat

public static float nextFloat(Random random)

Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the given Random sequence.

Parameters:
random - the Random sequence generator.
Returns:
the random float

nextDouble

public static double nextDouble()

Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the Math.random() sequence.

Returns:
the random double

nextDouble

public static double nextDouble(Random random)

Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from the given Random sequence.

Parameters:
random - the Random sequence generator.
Returns:
the random double


Copyright © 2001-2010 The Apache Software Foundation. All Rights Reserved.