Package org.apache.commons.rng

Interface JumpableUniformRandomProvider

All Superinterfaces:

UniformRandomProvider

All Known Subinterfaces:

LongJumpableUniformRandomProvider

public interface JumpableUniformRandomProvider
extends UniformRandomProvider

Applies to generators that can be advanced a large number of steps of the output sequence in a single operation.

Since:

1.3

Method Summary

Modifier and Type	Method	Description
UniformRandomProvider	jump()	Creates a copy of the UniformRandomProvider and then advances the state of the current instance.

Methods inherited from interface org.apache.commons.rng.UniformRandomProvider

nextBoolean, nextBytes, nextBytes, nextDouble, nextFloat, nextInt, nextInt, nextLong, nextLong

Method Detail

jump

UniformRandomProvider jump()

Creates a copy of the UniformRandomProvider and then advances the state of the current instance. The copy is returned.

The current state will be advanced in a single operation by the equivalent of a number of sequential calls to a method that updates the state of the provider. The size of the jump is implementation dependent.

Repeat invocations of this method will create a series of generators that are uniformly spaced at intervals of the output sequence. Each generator provides non-overlapping output for the length of the jump for use in parallel computations.

Returns:

A copy of the current state.