All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.util.Random

java.lang.Object
   |
   +----java.util.Random

public class Random
extends Object
implements Serializable
An instance of this class is used to generate a stream of pseudorandom numbers. The class uses a 48-bit seed, which is modified using a linear congruential formula. (See Donald Knuth, The Art of Computer Programming, Volume 2, Section 3.2.1.)

If two instances of Random are created with the same seed, and the same sequence of method calls is made for each, they will generate and return identical sequences of numbers.

Many applications will find the random method in class Math simpler to use.

See Also:
random

Constructor Index

 o Random()
Creates a new random number generator.
 o Random(long)
Creates a new random number generator using a single long seed.

Method Index

 o next(int)
Generates the next pseudorandom number.
 o nextBytes(byte[])
Generates a user specified number of random bytes.
 o nextDouble()
Returns the next pseudorandom, uniformly distributed double value between 0.0 and 1.0 from this random number generator's sequence.
 o nextFloat()
Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from this random number generator's sequence.
 o nextGaussian()
Returns the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and standard deviation 1.0 from this random number generator's sequence.
 o nextInt()
Returns the next pseudorandom, uniformly distributed int value from this random number generator's sequence.
 o nextLong()
Returns the next pseudorandom, uniformly distributed long value from this random number generator's sequence.
 o setSeed(long)
Sets the seed of this random number generator using a single long seed.

Constructors

 o Random
 public Random()
Creates a new random number generator. Its seed is initialized to a value based on the current time.

See Also:
currentTimeMillis
 o Random
 public Random(long seed)
Creates a new random number generator using a single long seed.

Parameters:
seed - the initial seed.
See Also:
setSeed

Methods

 o setSeed
 public synchronized void setSeed(long seed)
Sets the seed of this random number generator using a single long seed.

Parameters:
seed - the initial seed.
 o next
 protected synchronized int next(int bits)
Generates the next pseudorandom number. Subclass should override this, as this is used by all other methods.

Parameters:
bits - random bits
Returns:
the next pseudorandom value from this random number generator's sequence.
 o nextBytes
 public void nextBytes(byte bytes[])
Generates a user specified number of random bytes.

 o nextInt
 public int nextInt()
Returns the next pseudorandom, uniformly distributed int value from this random number generator's sequence.

Returns:
the next pseudorandom, uniformly distributed int value from this random number generator's sequence.
 o nextLong
 public long nextLong()
Returns the next pseudorandom, uniformly distributed long value from this random number generator's sequence.

Returns:
the next pseudorandom, uniformly distributed long value from this random number generator's sequence.
 o nextFloat
 public float nextFloat()
Returns the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from this random number generator's sequence.

Returns:
the next pseudorandom, uniformly distributed float value between 0.0 and 1.0 from this random number generator's sequence.
 o nextDouble
 public double nextDouble()
Returns the next pseudorandom, uniformly distributed double value between 0.0 and 1.0 from this random number generator's sequence.

Returns:
the next pseudorandom, uniformly distributed double value between 0.0 and 1.0 from this random number generator's sequence.
 o nextGaussian
 public synchronized double nextGaussian()
Returns the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and standard deviation 1.0 from this random number generator's sequence.

Returns:
the next pseudorandom, Gaussian ("normally") distributed double value with mean 0.0 and standard deviation 1.0 from this random number generator's sequence.

All Packages  Class Hierarchy  This Package  Previous  Next  Index

Submit a bug or feature - Version 1.1.8 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.