モジュール java.base

パッケージ java.util.random

インタフェースRandomGenerator.StreamableGenerator

すべてのスーパー・インタフェース:

RandomGenerator

既知のすべてのサブインタフェース:

RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator

既知のすべての実装クラス:

SplittableRandom

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

RandomGenerator

public static interface RandomGenerator.StreamableGenerator extends RandomGenerator

RandomGenerator.StreamableGeneratorインタフェースは、RandomGeneratorインタフェースを補強して、RandomGeneratorオブジェクトのストリームを返すメソッドを提供します。 このようなオブジェクトのストリームには、各オブジェクトの動作が他のオブジェクトすべてから静的に独立しているプロパティがあることが理想的です。 実際には、このプロパティの近似値に対して、決済が必要な場合があります。

インタフェースRandomGenerator.SplittableGeneratorを実装するジェネレータは、splits()メソッドを使用して、このインタフェースに必要なrngs()メソッドを実装することを選択できます。

インタフェースRandomGenerator.JumpableGeneratorを実装するジェネレータは、jumps()メソッドを使用して、このインタフェースに必要なrngs()メソッドを実装することを選択できます。

インタフェースRandomGenerator.LeapableGeneratorを実装するジェネレータは、leaps()メソッドを使用して、このインタフェースに必要なrngs()メソッドを実装することを選択できます。

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

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

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

RandomGenerator.ArbitrarilyJumpableGenerator, RandomGenerator.JumpableGenerator, RandomGenerator.LeapableGenerator, RandomGenerator.SplittableGenerator, RandomGenerator.StreamableGenerator

メソッドのサマリー

修飾子と型	メソッド	説明
static RandomGenerator.StreamableGenerator	of(String name)	name algorithmを利用するRandomGenerator.StreamableGeneratorのインスタンスを返します。
Stream<RandomGenerator>	rngs()	RandomGeneratorインタフェースを実装するオブジェクトの実質的に無制限のストリームを返します。
default Stream<RandomGenerator>	rngs(long streamSize)	RandomGeneratorインタフェースを実装するオブジェクトの実質的に無制限のストリームを返します。

インタフェース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.StreamableGenerator of(String name)

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

パラメータ:

name - 乱数ジェネレータの名前algorithm

戻り値:

RandomGenerator.StreamableGeneratorのインスタンス

例外:

NullPointerException - nameがnullである場合

IllegalArgumentException - 指定されたアルゴリズムが見つからない場合

rngs

Stream<RandomGenerator> rngs()

RandomGeneratorインタフェースを実装するオブジェクトの実質的に無制限のストリームを返します。 理想的には、ストリームのジェネレータは統計的に独立しているように見えます。 新しいジェネレータは、このジェネレータと同じalgorithmです。

実装上のノート:

このメソッドは、rngs (Long.MAX_VALUE)と同等の方法で実装できます。

戻り値:

RandomGeneratorインタフェースを実装するオブジェクトのストリーム

rngs

default Stream<RandomGenerator> rngs(long streamSize)

RandomGeneratorインタフェースを実装するオブジェクトの実質的に無制限のストリームを返します。 理想的には、ストリームのジェネレータは統計的に独立しているように見えます。 新しいジェネレータは、このジェネレータと同じalgorithmです。

実装要件:

デフォルトの実装はrngs()をコールし、その長さをstreamSizeに制限します。

パラメータ:

streamSize - 生成するジェネレータの数

戻り値:

RandomGeneratorインタフェースを実装するオブジェクトのストリーム

例外:

IllegalArgumentException - streamSizeが0未満の場合