Package Summary  Overview Summary

class:RandomGenerator.StreamableGenerator [NONE]

All Superinterfaces:
RandomGenerator
All Known Subinterfaces:
RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator
All Known Implementing Classes:
SplittableRandom
Enclosing interface:
RandomGenerator

public static interface RandomGenerator.StreamableGenerator extends RandomGenerator
The RandomGenerator.StreamableGenerator interface augments the RandomGenerator interface to provide methods that return streams of RandomGenerator objects. Ideally, such a stream of objects would have the property that the behavior of each object is statistically independent of all the others. In practice, one may have to settle for some approximation to this property.

A generator that implements interface RandomGenerator.SplittableGenerator may choose to use its splits() method to implement the rngs() method required by this interface.

A generator that implements interface RandomGenerator.JumpableGenerator may choose to use its jumps() method to implement the rngs() method required by this interface.

A generator that implements interface RandomGenerator.LeapableGenerator may choose to use its leaps() method to implement the rngs() method required by this interface.

Objects that implement RandomGenerator.StreamableGenerator are typically not cryptographically secure. Consider instead using SecureRandom to get a cryptographically secure pseudo-random number generator for use by security-sensitive applications.

method:of(java.lang.String) [NONE]

  • of

    Returns an instance of RandomGenerator.StreamableGenerator that utilizes the namealgorithm.
    Parameters:
    name - Name of random number generator algorithm
    Returns:
    An instance of RandomGenerator.StreamableGenerator
    Throws:
    NullPointerException - if name is null
    IllegalArgumentException - if the named algorithm is not found
  • method:rngs() [NONE]

    rngs

    Returns an effectively unlimited stream of objects, each of which implements the RandomGenerator interface. Ideally the generators in the stream will appear to be statistically independent. The new generators are of the same algorithm as this generator.
    Implementation Note:
    It is permitted to implement this method in a manner equivalent to rngs (Long.MAX_VALUE).
    Returns:
    a stream of objects that implement the RandomGenerator interface

    method:rngs(long) [NONE]

    rngs

    default Stream<RandomGenerator> rngs (long streamSize)
    Returns an effectively unlimited stream of objects, each of which implements the RandomGenerator interface. Ideally the generators in the stream will appear to be statistically independent. The new generators are of the same algorithm as this generator.
    Implementation Requirements:
    The default implementation calls rngs() and then limits its length to streamSize.
    Parameters:
    streamSize - the number of generators to generate
    Returns:
    a stream of objects that implement the RandomGenerator interface
    Throws:
    IllegalArgumentException - if streamSize is less than zero

    © 2023 Oracle Corporation and/or its affiliates