インタフェースRandomGenerator.LeapableGenerator

すべてのスーパー・インタフェース:
RandomGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.StreamableGenerator
既知のすべてのサブインタフェース:
RandomGenerator.ArbitrarilyJumpableGenerator
含まれているインタフェース:
RandomGenerator
public static interface RandomGenerator.LeapableGenerator extends RandomGenerator.JumpableGenerator
このインタフェースは、擬似乱数シーケンスを生成するオブジェクトに共通のプロトコルを提供するように設計されており、その状態サイクルの非常に遠いポイントに簡単に前方にジャンプできるだけでなく、飛躍(たとえば、2128)することもできます。 通常、1つは、単一の元のRandomGenerator.LeapableGeneratorオブジェクトからの繰返しリープによって一連のRandomGenerator.LeapableGeneratorオブジェクトを構築し、その各オブジェクトについて、反復的なジャンプによってオブジェクトのサブ・シリーズを生成します。 リープとジャンプには概念上の違いがほとんどありませんが、通常、リップは状態サイクル (おそらく距離2128など)の非常に長いジャンプになります。

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

単一のうるう操作を実行し、内部状態の反復的なコピーとリープによってオリジナルから生成されるジェネレータのストリームを生成する方法も用意されています。 生成されたジェネレータはRandomGenerator.JumpableGeneratorインタフェースを実装する必要がありますが、RandomGenerator.LeapableGeneratorインタフェースも実装する必要はありません。 マルチスレッド・アプリケーションの一般的な方法は、単一のRandomGenerator.LeapableGeneratorオブジェクトを作成し、そのleapsメソッドを1回だけ呼び出してから、結果のストリームのジェネレータを1つずつ各スレッドに分離することです。 次に、このような各ジェネレータのjump()メソッドを呼び出し、ジェネレータ・オブジェクトのサブ・ストリームを生成します。

RandomGenerator.LeapableGeneratorを実装するオブジェクトは通常、暗号方式ではセキュアではありません。 かわりに、SecureRandomを使用して、セキュリティ依存アプリケーションで使用する暗号学的にセキュアな疑似乱数ジェネレータを取得することを検討してください。

導入されたバージョン:
17

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

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

    RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator, RandomGenerator.StreamableGenerator
    修飾子と型
    インタフェース
    説明
    static interface 
    RandomGenerator.ArbitrarilyJumpableGenerator
    このインタフェースは、擬似乱数シーケンスを生成し、任意の量で簡単にjumpを状態サイクルの遠いポイントに送ることができるオブジェクトに共通のプロトコルを提供するように設計されています。
    static interface 
    RandomGenerator.JumpableGenerator
    このインタフェースは、擬似乱数値を生成するオブジェクトに共通のプロトコルを提供するように設計されており、状態サイクル内の離れた場所に適度な量(たとえば264)で簡単に前方にジャンプできます。
    static interface 
    RandomGenerator.LeapableGenerator
    このインタフェースは、擬似乱数シーケンスを生成するオブジェクトに共通のプロトコルを提供するように設計されており、その状態サイクルの非常に遠いポイントに簡単に前方にジャンプできるだけでなく、飛躍(たとえば、2128)することもできます。
    static interface 
    RandomGenerator.SplittableGenerator
    このインタフェースは、擬似乱数値の順序を生成するオブジェクトに共通プロトコルを提供するように設計されており、それぞれ(元のものと新しいもの)という2つのオブジェクトに「分割」で、同じプロトコル(したがって、無期限に再帰的に分割できます)に従うことができます。
    static interface 
    RandomGenerator.StreamableGenerator
    RandomGenerator.StreamableGeneratorインタフェースは、RandomGeneratorインタフェースを補強して、RandomGeneratorオブジェクトのストリームを返すメソッドを提供します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    RandomGenerator.LeapableGenerator
    copy()
    内部状態がこのジェネレータ (したがって、同じ一連の操作の対象となる場合は、将来の動作は同じである必要があります)の正確なコピーである新しいジェネレータを返します。
    default RandomGenerator.JumpableGenerator
    copyAndLeap()
    このジェネレータをコピーし、このジェネレータを前方に傾け、コピーを返します。
    void
    leap()
    この擬似乱数ジェネレータの状態を変更して、その状態サイクル内の大きな固定距離の (通常は296以上)を前方に向けます。
    double
    leapDistance()
    このジェネレータ・オブジェクトの状態サイクル内でleap()メソッドが前方に飛ぶ距離を返します。
    default Stream<RandomGenerator.JumpableGenerator>
    leaps()
    RandomGenerator.JumpableGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。
    default Stream<RandomGenerator.JumpableGenerator>
    leaps(long streamSize)
    RandomGenerator.JumpableGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。
    static RandomGenerator.LeapableGenerator
    of(String name)
    name algorithmを利用するRandomGenerator.LeapableGeneratorのインスタンスを返します。

    インタフェースで宣言されたメソッド 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
    修飾子と型
    メソッド
    説明
    default DoubleStream
    doubles()
    擬似乱数的に選択されたdouble値の実質的に無制限のストリームを返します。
    default DoubleStream
    doubles(double randomNumberOrigin, double randomNumberBound)
    擬似乱数的に選択したdouble値の実質的に無制限のストリームを返します。各値は、指定された起点(包含)と指定された境界(除外)の間です。
    default DoubleStream
    doubles(long streamSize)
    指定されたstreamSize数の擬似乱数的に選択したdouble値を生成するストリームを返します。
    default DoubleStream
    doubles(long streamSize, double randomNumberOrigin, double randomNumberBound)
    擬似乱数的に選択したdouble値のstreamSize数を生成するストリームを返します。各値は、指定された起点(包含)と、指定された境界(除外)の間です。
    default DoubleStream
    equiDoubles(double left, double right, boolean isLeftIncluded, boolean isRightIncluded)
    疑似ランダムに選択されたdouble値の事実上無制限のストリームを返します。各値は、指定されたleft境界と指定されたright境界の間にあります。
    default IntStream
    ints()
    擬似乱数的に選択されたint値の実質的に無制限のストリームを返します。
    default IntStream
    ints(int randomNumberOrigin, int randomNumberBound)
    擬似乱数的に選択したint値の実質的に無制限のストリームを返します。各値は、指定された起点(包含)と指定された境界(除外)の間です。
    default IntStream
    ints(long streamSize)
    指定されたstreamSize数の擬似乱数的に選択したint値を生成するストリームを返します。
    default IntStream
    ints(long streamSize, int randomNumberOrigin, int randomNumberBound)
    指定された擬似乱数的に選択したint値のstreamSize数を生成するストリームを返します。各値は、指定された起点(包含)と、指定された境界(除外)の間です。
    default boolean
    isDeprecated()
    RandomGenerator (algorithm)の実装が非推奨としてマークされている場合はtrueを返します。
    default LongStream
    longs()
    擬似乱数的に選択されたlong値の実質的に無制限のストリームを返します。
    default LongStream
    longs(long streamSize)
    指定されたstreamSize数の擬似乱数的に選択したlong値を生成するストリームを返します。
    default LongStream
    longs(long randomNumberOrigin, long randomNumberBound)
    擬似乱数的に選択したlong値の実質的に無制限のストリームを返します。各値は、指定された起点(包含)と指定された境界(除外)の間です。
    default LongStream
    longs(long streamSize, long randomNumberOrigin, long randomNumberBound)
    擬似乱数的に選択したlong値のstreamSize数を生成するストリームを返します。各値は、指定された起点(包含)と、指定された境界(除外)の間です。
    default boolean
    nextBoolean()
    擬似乱数的に選択したboolean値を返します。
    default void
    nextBytes(byte[] bytes)
    -128 (包含)と127 (包含)の間の値範囲から擬似乱数的に選択された一様なバイト値が生成されたユーザー指定のバイト配列になります。
    default double
    nextDouble()
    0 (これを含む)から1 (これを含まない)までの、擬似乱数のdouble値を返します。
    default double
    nextDouble(double bound)
    ゼロ(包含)と指定した境界(除外)の間の擬似乱数的に選択したdouble値を返します。
    default double
    nextDouble(double origin, double bound)
    指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したdouble値を返します。
    default double
    nextExponential()
    平均が1である指数分布から擬似乱数的に選択された、負でないdouble値を返します。
    default float
    nextFloat()
    0(これを含む)から1(これを含まない)までの範囲で、擬似乱数のfloat値を返します。
    default float
    nextFloat(float bound)
    ゼロ(包含)と指定したバインド(除外)の間の擬似乱数的に選択したfloat値を返します。
    default float
    nextFloat(float origin, float bound)
    指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したfloat値を返します。
    default double
    nextGaussian()
    平均が0で、標準偏差が1であるガウス(正規)分布から擬似乱数的に選択されたdouble値を返します。
    default double
    nextGaussian(double mean, double stddev)
    ガウス(正規)分布から擬似乱数的に選択されたdouble値を、引数で指定された平均偏差および標準偏差で返します。
    default int
    nextInt()
    擬似乱数的に選択したint値を返します。
    default int
    nextInt(int bound)
    ゼロ(包含)と指定した境界(除外)の間の擬似乱数的に選択したint値を返します。
    default int
    nextInt(int origin, int bound)
    指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したint値を返します。
    long
    nextLong()
    擬似乱数的に選択したlong値を返します。
    default long
    nextLong(long bound)
    ゼロ(包含)と指定した境界(除外)の間の擬似乱数的に選択したlong値を返します。
    default long
    nextLong(long origin, long bound)
    指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したlong値を返します。

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

    copyAndJump, jump, jumpDistance, jumps, jumps, rngs, rngs
    修飾子と型
    メソッド
    説明
    default RandomGenerator
    copyAndJump()
    このジェネレータをコピーし、このジェネレータを前方にジャンプしてから、コピーを返します。
    void
    jump()
    この擬似乱数ジェネレータの状態を変更して、その状態サイクル内の大きな固定距離(通常は264以上)を前方にジャンプします。
    double
    jumpDistance()
    このジェネレータ・オブジェクトの状態サイクル内でjump()メソッドが前方にジャンプする距離を返します。
    default Stream<RandomGenerator>
    jumps()
    RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。
    default Stream<RandomGenerator>
    jumps(long streamSize)
    RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。
    default Stream<RandomGenerator>
    rngs()
    RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。
    default Stream<RandomGenerator>
    rngs(long streamSize)
    RandomGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。

  • メソッドの詳細

    • of

      static RandomGenerator.LeapableGenerator of(String name)
      name algorithmを利用するRandomGenerator.LeapableGeneratorのインスタンスを返します。
      パラメータ:
      name - 乱数ジェネレータの名前algorithm
      戻り値:
      RandomGenerator.LeapableGeneratorのインスタンス
      スロー:
      NullPointerException - nameがnullである場合
      IllegalArgumentException - 指定されたアルゴリズムが見つからない場合

    • copy

      RandomGenerator.LeapableGenerator copy()
      内部状態がこのジェネレータ (したがって、同じ一連の操作の対象となる場合は、将来の動作は同じである必要があります)の正確なコピーである新しいジェネレータを返します。
      定義:
      インタフェースRandomGenerator.JumpableGenerator内のcopy
      戻り値:
      このジェネレータのコピーである新規オブジェクト

    • leap

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

    • leapDistance

      double leapDistance()
      このジェネレータ・オブジェクトの状態サイクル内でleap()メソッドが前方に飛ぶ距離を返します。
      戻り値:
      デフォルトのリープ距離(double値として)

    • leaps

      default Stream<RandomGenerator.JumpableGenerator> leaps()
      RandomGenerator.JumpableGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの実質的に無制限のストリームを返します。
      実装要件:
      デフォルトの実装では、このジェネレータでcopy()およびleap()を繰り返し呼び出す順次ストリームが生成され、コピーはストリームによって生成されたジェネレータになります。
      実装上のノート:
      このメソッドは、leaps (Long.MAX_VALUE)と同等の方法で実装できます。
      戻り値:
      RandomGenerator.JumpableGeneratorインタフェースを実装するオブジェクトのストリーム

    • leaps

      default Stream<RandomGenerator.JumpableGenerator> leaps(long streamSize)
      RandomGenerator.JumpableGeneratorインタフェースを実装する新しい擬似乱数ジェネレータの特定のstreamSize数を生成するストリームを返します。
      実装要件:
      デフォルトの実装では、このジェネレータでcopy()およびleap()を繰り返し呼び出す順次ストリームが生成され、コピーはストリームによって生成されたジェネレータになります。
      パラメータ:
      streamSize - 生成するジェネレータの数
      戻り値:
      RandomGenerator.JumpableGeneratorインタフェースを実装するオブジェクトのストリーム
      スロー:
      IllegalArgumentException - streamSizeが0未満の場合

    • copyAndLeap

      default RandomGenerator.JumpableGenerator copyAndLeap()
      このジェネレータをコピーし、このジェネレータを前方に傾け、コピーを返します。
      実装要件:
      デフォルトの実装では、これをコピーし、リープしてからコピーを返します。
      戻り値:
      うるう発生前のこのジェネレータ・オブジェクトのコピー