インタフェースRandomGenerator.JumpableGenerator

すべてのスーパー・インタフェース:
RandomGenerator, RandomGenerator.StreamableGenerator
既知のすべてのサブインタフェース:
RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.LeapableGenerator
含まれているインタフェース:
RandomGenerator
public static interface RandomGenerator.JumpableGenerator extends RandomGenerator.StreamableGenerator
このインタフェースは、擬似乱数値を生成するオブジェクトに共通のプロトコルを提供するように設計されており、状態サイクル内の離れた場所に適度な量(たとえば264)で簡単に前方にジャンプできます。

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

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

RandomGenerator.JumpableGeneratorを実装するオブジェクトは通常、暗号方式ではセキュアではありません。 かわりに、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.JumpableGenerator
    copy()
    内部状態がこのジェネレータ (したがって、同じ一連の操作の対象となる場合は、将来の動作は同じである必要があります)の正確なコピーである新しいジェネレータを返します。
    default RandomGenerator
    copyAndJump()
    このジェネレータをコピーし、このジェネレータを前方にジャンプしてから、コピーを返します。
    void
    jump()
    この擬似乱数ジェネレータの状態を変更して、その状態サイクル内の大きな固定距離(通常は264以上)を前方にジャンプします。
    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数を生成するストリームを返します。

    インタフェースで宣言されたメソッド 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値を返します。

  • メソッドの詳細

    • 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()
      この擬似乱数ジェネレータの状態を変更して、その状態サイクル内の大きな固定距離(通常は264以上)を前方にジャンプします。

    • 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()
      このジェネレータをコピーし、このジェネレータを前方にジャンプしてから、コピーを返します。
      実装要件:
      デフォルトの実装では、これをコピーしてジャンプし、コピーを返します。
      戻り値:
      ジャンプが発生した前のこのジェネレータ・オブジェクトのコピー