すべてのスーパー・インタフェース:: RandomGenerator, RandomGenerator.StreamableGenerator

既知のすべてのサブインタフェース:: RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.LeapableGenerator

含まれているインタフェース:: RandomGenerator

public static interface RandomGenerator.JumpableGenerator extends RandomGenerator.StreamableGenerator

このインタフェースは、擬似乱数値を生成するオブジェクトに共通のプロトコルを提供するように設計されており、状態サイクル内の離れた場所に適度な量(たとえば2⁶⁴)で簡単に前方にジャンプできます。

理想的には、1つの元のRandomGenerator.JumpableGeneratorオブジェクトからの反復ジャンプによって生成されたすべてのRandomGenerator.JumpableGeneratorオブジェクトは、統計的に相互に独立しており、個別に均一です。実際には、ある程度の近似で独立性と均一性を決める必要があります。特に、特定の実装では、jump()メソッドによって生成されたストリームの各ジェネレータを使用して、2⁶⁴またはその期間の平方根以下の数値を生成できます。実装者は、期間が2¹²⁷以上のアルゴリズムを使用することをお薦めします。

単一のジャンプ操作を実行し、内部状態の反復的なコピーとジャンプによってオリジナルから生成されるジェネレータのストリームを生成する方法も用意されています。マルチスレッド・アプリケーションの一般的な方法は、単一のRandomGenerator.JumpableGeneratorオブジェクトを作成し、そのjump()メソッドを1回だけ呼び出してから、結果のストリームから1つずつ、各スレッドに1つずつジェネレータをパーティション化することです。通常、jump()メソッドによって生成されたジェネレータでjump()をコールすることはお薦めしません。結果は、jump()メソッドへのコールによってすでに生成された別のジェネレータと同じジェネレータの場合があるためです。このため、ストリーム内の実際のジェネレータ・オブジェクトもRandomGenerator.JumpableGeneratorインタフェースを実装する可能性が高い場合でも、jumps()メソッドの戻り型はStream<RandomGenerator.JumpableGenerator>ではなくStream<RandomGenerator>です。

RandomGenerator.JumpableGeneratorを実装するオブジェクトは通常、暗号方式ではセキュアではありません。セキュリティ保護を必要とするアプリケーションで使用するために安全な暗号化の施された擬似乱数ジェネレータを取得するには、代わりにSecureRandomを使用することを検討してください。

ネストされたクラスのサマリー

インタフェースjava.util.random.RandomGeneratorで宣言されたネストされたクラス/インタフェース
RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator, RandomGenerator.StreamableGenerator
メソッドのサマリー

修飾子と型

メソッド

説明

RandomGenerator.JumpableGenerator

copy()

内部状態がこのジェネレータ (したがって、同じ一連の操作の対象となる場合は、将来の動作は同じである必要があります)の正確なコピーである新しいジェネレータを返します。

default RandomGenerator

copyAndJump()

このジェネレータをコピーし、このジェネレータを前方にジャンプしてから、コピーを返します。

void

jump()

この擬似乱数ジェネレータの状態を変更して、その状態サイクル内の大きな固定距離(通常は2⁶⁴以上)を前方にジャンプします。

double

jumpDistance()

このジェネレータ・オブジェクトの状態サイクル内でjump()メソッドが前方にジャンプする距離を返します。

default Stream<RandomGenerator>

jumps()

RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。

default Stream<RandomGenerator>

jumps(long streamSize)

RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。

static RandomGenerator.JumpableGenerator

of(String name)

name algorithmを利用するRandomGenerator.JumpableGeneratorのインスタンスを返します。

default Stream<RandomGenerator>

rngs()

RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。

default Stream<RandomGenerator>

rngs(long streamSize)

RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。

インタフェースjava.util.random.RandomGeneratorで宣言されたメソッド
doubles, doubles, doubles, doubles, equiDoubles, ints, ints, ints, ints, isDeprecated, longs, longs, longs, longs, nextBoolean, nextBytes, nextDouble, nextDouble, nextDouble, nextExponential, nextFloat, nextFloat, nextFloat, nextGaussian, nextGaussian, nextInt, nextInt, nextInt, nextLong, nextLong, nextLong

メソッドの詳細
- of
  
  static RandomGenerator.JumpableGenerator of(String name)
  
  name algorithmを利用するRandomGenerator.JumpableGeneratorのインスタンスを返します。
  
  パラメータ:
  
  name - 乱数ジェネレータの名前algorithm
  
  戻り値:
  
  RandomGenerator.JumpableGeneratorのインスタンス
  
  例外:
  
  NullPointerException - nameがnullである場合
  
  IllegalArgumentException - 指定されたアルゴリズムが見つからない場合
- copy
  
  RandomGenerator.JumpableGenerator copy()
  
  内部状態がこのジェネレータ (したがって、同じ一連の操作の対象となる場合は、将来の動作は同じである必要があります)の正確なコピーである新しいジェネレータを返します。
  
  戻り値:
  
  このジェネレータのコピーである新規オブジェクト
- jump
  
  void jump()
  
  この擬似乱数ジェネレータの状態を変更して、その状態サイクル内の大きな固定距離(通常は2⁶⁴以上)を前方にジャンプします。
- jumpDistance
  
  double jumpDistance()
  
  このジェネレータ・オブジェクトの状態サイクル内でjump()メソッドが前方にジャンプする距離を返します。
  
  戻り値:
  
  デフォルトのジャンプ距離(double値として)
- jumps
  
  default Stream<RandomGenerator> jumps()
  
  RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。
  
  実装要件:
  
  デフォルトの実装では、このジェネレータでcopy()およびjump()を繰り返し呼び出す順次ストリームが生成され、コピーはストリームによって生成されたジェネレータになります。
  
  実装上のノート:
  
  このメソッドは、jumps (Long.MAX_VALUE)と同等の方法で実装できます。
  
  戻り値:
  
  RandomGeneratorインタフェースを実装するオブジェクトのストリーム
- jumps
  
  default Stream<RandomGenerator> jumps(long streamSize)
  
  RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。
  
  実装要件:
  
  デフォルトの実装では、このジェネレータでcopy()およびjump()を繰り返し呼び出す順次ストリームが生成され、コピーはストリームによって生成されたジェネレータになります。
  
  パラメータ:
  
  streamSize - 生成するジェネレータの数
  
  戻り値:
  
  RandomGeneratorインタフェースを実装するオブジェクトのストリーム
  
  例外:
  
  IllegalArgumentException - streamSizeが0未満の場合
- rngs
  
  default Stream<RandomGenerator> rngs()
  
  RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。理想的には、ストリームのジェネレータは統計的に独立しているように見えます。
  
  定義:
  
  インタフェースRandomGenerator.StreamableGenerator内のrngs
  
  実装要件:
  
  デフォルトの実装では、jumps()がコールされます。
  
  戻り値:
  
  RandomGeneratorインタフェースを実装するオブジェクトのストリーム
- rngs
  
  default Stream<RandomGenerator> rngs(long streamSize)
  
  RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。理想的には、ストリームのジェネレータは統計的に独立しているように見えます。
  
  定義:
  
  インタフェースRandomGenerator.StreamableGenerator内のrngs
  
  実装要件:
  
  デフォルトの実装では、jumps(streamSize)をコールします。
  
  パラメータ:
  
  streamSize - 生成するジェネレータの数
  
  戻り値:
  
  RandomGeneratorインタフェースを実装するオブジェクトのストリーム
  
  例外:
  
  IllegalArgumentException - streamSizeが0未満の場合
- copyAndJump
  
  default RandomGenerator copyAndJump()
  
  このジェネレータをコピーし、このジェネレータを前方にジャンプしてから、コピーを返します。
  
  実装要件:
  
  デフォルトの実装では、これをコピーしてジャンプし、コピーを返します。
  
  戻り値:
  
  ジャンプが発生した前のこのジェネレータ・オブジェクトのコピー

インタフェースRandomGenerator.JumpableGenerator

ネストされたクラスのサマリー

インタフェースjava.util.random.RandomGeneratorで宣言されたネストされたクラス/インタフェース

メソッドのサマリー

インタフェースjava.util.random.RandomGeneratorで宣言されたメソッド

メソッドの詳細

of

copy

jump

jumpDistance

jumps

jumps

rngs

rngs

copyAndJump