クラスThreadLocalRandom

java.lang.Object

java.util.Random

java.util.concurrent.ThreadLocalRandom

すべての実装されたインタフェース:

Serializable, RandomGenerator

public final class ThreadLocalRandom extends Random

現在のスレッドに分離された乱数ジェネレータ(期間2⁶⁴)。 Mathクラスによって使用されるグローバルなRandomジェネレータと同様に、ThreadLocalRandomは、それ以外では変更できない内部的に生成されたシードで初期化されます。 該当する� �合、並行プログラ� 内の共有されたRandomオブジェクトではなくThreadLocalRandomを使用すれば、通常、発生するオーバーヘッドや競合がはるかに少なくなります。 ThreadLocalRandomの使用は、複数のタスク(たとえば、各ForkJoinTask)がスレッド・プール内で並列に乱数を使用している� �合に特に適しています。

このクラスの使用法は通常、ThreadLocalRandom.current().nextX(...) (ここで、XはIntやLongなど)の形式にするようにしてく� さい。 すべての使用方法がこの形式である� �合、誤って複数のスレッドでThreadLocalRandomを共有することはできません。

このクラスはまた、追� の一般的に使用される制約付きランダ� 生成メソッドも提供します。

ThreadLocalRandomのインスタンスにはセキュアな暗号化が施されていません。 セキュリティに依存するアプリケーションでは、かわりにSecureRandomの使用を検討してく� さい。 また、システ� ・プロパティjava.util.secureRandomSeedをtrueに設定しないかぎり、デフォルトで構築されるインスタンスは暗号化処理に乱数シードを使用しません。

導入されたバージョン:

1.7

関連� �目:

• 直列化された形式

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

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

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

メソッドのサマリー

修飾子と型	メソッド	説明
static ThreadLocalRandom	current()	現在のスレッドThreadLocalRandomオブジェクトを返します。
DoubleStream	doubles()	0(含む)から1(含まない)までの擬似乱数 double値を含む、事実上無制限のストリー� を返します。
DoubleStream	doubles(double randomNumberOrigin, double randomNumberBound)	指定された起点(含む)と境界(含まない)に準� した擬似乱数 double値を含む、事実上無制限のストリー� を返します。
DoubleStream	doubles(long streamSize)	0(含む)から1(含まない)までの擬似乱数double値を、指定されたstreamSize数� け生成するストリー� を返します。
DoubleStream	doubles(long streamSize, double randomNumberOrigin, double randomNumberBound)	指定された起点(含む)と境界(含まない)に準� した擬似乱数double値を、指定されたstreamSize数� け生成するストリー� を返します。
IntStream	ints()	擬似乱数int値を含む、事実上無制限のストリー� を返します。
IntStream	ints(int randomNumberOrigin, int randomNumberBound)	指定された起点(含む)と境界(含まない)に準� した擬似乱数 int値を含む、事実上無制限のストリー� を返します。
IntStream	ints(long streamSize)	擬似乱数int値を、指定されたstreamSize数� け生成するストリー� を返します。
IntStream	ints(long streamSize, int randomNumberOrigin, int randomNumberBound)	指定された起点(含む)と境界(含まない)に準� した擬似乱数int値を、指定されたstreamSize数� け生成するストリー� を返します。
LongStream	longs()	擬似乱数long値を含む、事実上無制限のストリー� を返します。
LongStream	longs(long streamSize)	擬似乱数long値を、指定されたstreamSize数� け生成するストリー� を返します。
LongStream	longs(long randomNumberOrigin, long randomNumberBound)	指定された起点(含む)と境界(含まない)に準� した擬似乱数 long値を含む、事実上無制限のストリー� を返します。
LongStream	longs(long streamSize, long randomNumberOrigin, long randomNumberBound)	指定された起点(含む)と境界(含まない)に準� した擬似乱数longを、指定されたstreamSize数� け生成するストリー� を返します。
protected int	next(int bits)	指定された下位ビット数の疑似乱数を生成します。
double	nextDouble(double bound)	ゼロ(包含)と指定した境界(除外)の間の擬似乱数的に選択したdouble値を返します。
double	nextDouble(double origin, double bound)	指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したdouble値を返します。
float	nextFloat(float bound)	ゼロ(包含)と指定したバインド(除外)の間の擬似乱数的に選択したfloat値を返します。
float	nextFloat(float origin, float bound)	指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したfloat値を返します。
int	nextInt(int bound)	この乱数ジェネレータのシーケンスを使って、0から指定された値の範囲(0は含むが、その指定された値は含まない)で一様分布のint型の擬似乱数値を返します。
int	nextInt(int origin, int bound)	指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したint値を返します。
long	nextLong(long bound)	ゼロ(包含)と指定した境界(除外)の間の擬似乱数的に選択したlong値を返します。
long	nextLong(long origin, long bound)	指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したlong値を返します。
void	setSeed(long seed)	UnsupportedOperationExceptionをスローします。

クラスjava.util.Randomで宣言されたメソッド

from, nextBoolean, nextBytes, nextDouble, nextFloat, nextGaussian, nextInt, nextLong

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

equiDoubles, isDeprecated, nextExponential, nextGaussian

メソッドの詳細

current

public static ThreadLocalRandom current()

現在のスレッドThreadLocalRandomオブジェクトを返します。 このオブジェクトのメソッドは、他のスレッドではなく現在のスレッドによってのみコールする必要があります。

戻り値:

現在のスレッドのThreadLocalRandom

setSeed

public void setSeed(long seed)

UnsupportedOperationExceptionをスローします。 このジェネレータでのシードの設定はサポートされていません。

オーバーライド:

setSeed、クラスRandom

パラメータ:

seed - シード値

スロー:

UnsupportedOperationException - 常時

next

protected int next(int bits)

指定された下位ビット数の疑似乱数を生成します。 このクラスにはサブクラスがないため、このメソッドを起動またはオーバーライドできません。

オーバーライド:

next、クラスRandom

パラメータ:

bits - ランダ� ・ビット

戻り値:

この乱数ジェネレータのシーケンスに基づく次の擬似乱数値

nextInt

public int nextInt(int bound)

この乱数ジェネレータのシーケンスを使って、0から指定された値の範囲(0は含むが、その指定された値は含まない)で一様分布のint型の擬似乱数値を返します。 nextIntの一般規約では、指定された範囲内の1つのint型の値が擬似乱数として生成されて返されます。 bound個のすべての可能なint値が(ほぼ)均等な確率で生成されます。

定義:

インタフェースRandomGenerator内のnextInt

オーバーライド:

nextInt、クラスRandom

パラメータ:

bound - 上限(含まない)。 正の値でなければならない

戻り値:

この乱数ジェネレータのシーケンスを使った、0(含む)からbound(含まない)の範囲で一様分布の、int型の次の擬似乱数値

スロー:

IllegalArgumentException - boundが正でない� �合

nextInt

public int nextInt(int origin, int bound)

指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したint値を返します。

パラメータ:

origin - 戻り値

bound - 返される値の上限(除外)

戻り値:

起点(包含)と境界(除外)の間の擬似乱数的に選択したint値

スロー:

IllegalArgumentException - originがboundより大きいか等しい� �合

nextLong

public long nextLong(long bound)

ゼロ(包含)と指定した境界(除外)の間の擬似乱数的に選択したlong値を返します。

パラメータ:

bound - 返される値の上限(除外)。 正の値でなければならない

戻り値:

0 (包含)と境界(除外)の間の擬似乱数的に選択したlong値

スロー:

IllegalArgumentException - boundが正でない� �合

nextLong

public long nextLong(long origin, long bound)

指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したlong値を返します。

パラメータ:

origin - 戻り値

bound - 返される値の上限(除外)

戻り値:

起点(包含)と境界(除外)の間の擬似乱数的に選択したlong値

スロー:

IllegalArgumentException - originがboundより大きいか等しい� �合

nextFloat

public float nextFloat(float bound)

ゼロ(包含)と指定したバインド(除外)の間の擬似乱数的に選択したfloat値を返します。

実装上のノート:

パラメータ:

bound - 返される値の上限(除外)。 正および有限である必要があります

戻り値:

0 (包含)とバインドされた(除外)の間の擬似乱数的に選択したfloat値

スロー:

IllegalArgumentException - boundが正と有限の両方でない� �合

導入されたバージョン:

17

nextFloat

public float nextFloat(float origin, float bound)

指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したfloat値を返します。

実装上のノート:

パラメータ:

origin - 戻り値

bound - 上限(含まない)

戻り値:

起点(包含)と境界(除外)の間の擬似乱数的に選択したfloat値

スロー:

IllegalArgumentException - originが有限でない� �合、またはboundが有限でない� �合、またはoriginがbound以上である� �合

導入されたバージョン:

17

nextDouble

public double nextDouble(double bound)

ゼロ(包含)と指定した境界(除外)の間の擬似乱数的に選択したdouble値を返します。

実装上のノート:

パラメータ:

bound - 返される値の上限(除外)。 正および有限である必要があります

戻り値:

0 (包含)と境界(除外)の間の擬似乱数的に選択したdouble値

スロー:

IllegalArgumentException - boundが正と有限の両方でない� �合

nextDouble

public double nextDouble(double origin, double bound)

指定された起点(包含)と指定された境界(除外)の間の擬似乱数的に選択したdouble値を返します。

実装上のノート:

パラメータ:

origin - 戻り値

bound - 返される値の上限(除外)

戻り値:

起点(包含)と境界(除外)の間の擬似乱数的に選択したdouble値

スロー:

IllegalArgumentException - originが有限でない� �合、またはboundが有限でない� �合、またはoriginがbound以上である� �合

ints

public IntStream ints(long streamSize)

擬似乱数int値を、指定されたstreamSize数� け生成するストリー� を返します。

メソッドRandom.nextInt()をコールした結果として、擬似乱数int値が生成されます。

定義:

インタフェースRandomGenerator内のints

オーバーライド:

ints、クラスRandom

パラメータ:

streamSize - 生成する値の数

戻り値:

擬似乱数int値のストリー�

スロー:

IllegalArgumentException - streamSizeが0未満の� �合

導入されたバージョン:

1.8

ints

public IntStream ints()

擬似乱数int値を含む、事実上無制限のストリー� を返します。

メソッドRandom.nextInt()をコールした結果として、擬似乱数int値が生成されます。

定義:

インタフェースRandomGenerator内のints

オーバーライド:

ints、クラスRandom

実装上のノート:

このメソッドは、ints(Long.MAX_VALUE)と同等であるように実装されます。

戻り値:

擬似乱数int値のストリー�

導入されたバージョン:

1.8

ints

public IntStream ints(long streamSize, int randomNumberOrigin, int randomNumberBound)

指定された起点(含む)と境界(含まない)に準� した擬似乱数int値を、指定されたstreamSize数� け生成するストリー� を返します。

起点と境界を指定した次のメソッド呼び出しの結果と同様に、擬似乱数int値が生成されます。

 
 int nextInt(int origin, int bound) {
   int n = bound - origin;
   if (n > 0) {
     return nextInt(n) + origin;
   }
   else {  // range not representable as int
     int r;
     do {
       r = nextInt();
     } while (r < origin || r >= bound);
     return r;
   }
 }

定義:

インタフェースRandomGenerator内のints

オーバーライド:

ints、クラスRandom

パラメータ:

streamSize - 生成する値の数

randomNumberOrigin - 各乱数値の起点(含む)

randomNumberBound - 各乱数値の境界(含まない)

戻り値:

それぞれ起点(含む)と境界(含まない)が指定された、擬似乱数int値のストリー�

スロー:

IllegalArgumentException - streamSizeが0未満の� �合、またはrandomNumberOriginがrandomNumberBound以上の� �合

導入されたバージョン:

1.8

ints

public IntStream ints(int randomNumberOrigin, int randomNumberBound)

指定された起点(含む)と境界(含まない)に準� した擬似乱数 int値を含む、事実上無制限のストリー� を返します。

起点と境界を指定した次のメソッド呼び出しの結果と同様に、擬似乱数int値が生成されます。

 
 int nextInt(int origin, int bound) {
   int n = bound - origin;
   if (n > 0) {
     return nextInt(n) + origin;
   }
   else {  // range not representable as int
     int r;
     do {
       r = nextInt();
     } while (r < origin || r >= bound);
     return r;
   }
 }

定義:

インタフェースRandomGenerator内のints

オーバーライド:

ints、クラスRandom

実装上のノート:

このメソッドは、ints(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound)と同等であるように実装されます。

パラメータ:

randomNumberOrigin - 各乱数値の起点(含む)

randomNumberBound - 各乱数値の境界(含まない)

戻り値:

それぞれ起点(含む)と境界(含まない)が指定された、擬似乱数int値のストリー�

スロー:

IllegalArgumentException - randomNumberOriginがrandomNumberBound以上の� �合

導入されたバージョン:

1.8

longs

public LongStream longs(long streamSize)

擬似乱数long値を、指定されたstreamSize数� け生成するストリー� を返します。

メソッドRandom.nextLong()をコールした結果として、擬似乱数long値が生成されます。

定義:

インタフェースRandomGenerator内のlongs

オーバーライド:

longs、クラスRandom

パラメータ:

streamSize - 生成する値の数

戻り値:

擬似乱数long値のストリー�

スロー:

IllegalArgumentException - streamSizeが0未満の� �合

導入されたバージョン:

1.8

longs

public LongStream longs()

擬似乱数long値を含む、事実上無制限のストリー� を返します。

メソッドRandom.nextLong()をコールした結果として、擬似乱数long値が生成されます。

定義:

インタフェースRandomGenerator内のlongs

オーバーライド:

longs、クラスRandom

実装上のノート:

このメソッドは、longs(Long.MAX_VALUE)と同等であるように実装されます。

戻り値:

擬似乱数long値のストリー�

導入されたバージョン:

1.8

longs

public LongStream longs(long streamSize, long randomNumberOrigin, long randomNumberBound)

指定された起点(含む)と境界(含まない)に準� した擬似乱数longを、指定されたstreamSize数� け生成するストリー� を返します。

起点と境界を指定した次のメソッド呼び出しの結果と同様に、擬似乱数long値が生成されます。

 
 long nextLong(long origin, long bound) {
   long r = nextLong();
   long n = bound - origin, m = n - 1;
   if ((n & m) == 0L)  // power of two
     r = (r & m) + origin;
   else if (n > 0L) {  // reject over-represented candidates
     for (long u = r >>> 1;            // ensure nonnegative
          u + m - (r = u % n) < 0L;    // rejection check
          u = nextLong() >>> 1) // retry
         ;
     r += origin;
   }
   else {              // range not representable as long
     while (r < origin || r >= bound)
       r = nextLong();
   }
   return r;
 }

定義:

インタフェースRandomGenerator内のlongs

オーバーライド:

longs、クラスRandom

パラメータ:

streamSize - 生成する値の数

randomNumberOrigin - 各乱数値の起点(含む)

randomNumberBound - 各乱数値の境界(含まない)

戻り値:

それぞれ起点(含む)と境界(含まない)が指定された、擬似乱数long値のストリー�

スロー:

IllegalArgumentException - streamSizeが0未満の� �合、またはrandomNumberOriginがrandomNumberBound以上の� �合

導入されたバージョン:

1.8

longs

public LongStream longs(long randomNumberOrigin, long randomNumberBound)

指定された起点(含む)と境界(含まない)に準� した擬似乱数 long値を含む、事実上無制限のストリー� を返します。

起点と境界を指定した次のメソッド呼び出しの結果と同様に、擬似乱数long値が生成されます。

 
 long nextLong(long origin, long bound) {
   long r = nextLong();
   long n = bound - origin, m = n - 1;
   if ((n & m) == 0L)  // power of two
     r = (r & m) + origin;
   else if (n > 0L) {  // reject over-represented candidates
     for (long u = r >>> 1;            // ensure nonnegative
          u + m - (r = u % n) < 0L;    // rejection check
          u = nextLong() >>> 1) // retry
         ;
     r += origin;
   }
   else {              // range not representable as long
     while (r < origin || r >= bound)
       r = nextLong();
   }
   return r;
 }

定義:

インタフェースRandomGenerator内のlongs

オーバーライド:

longs、クラスRandom

実装上のノート:

このメソッドは、longs(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound)と同等であるように実装されます。

パラメータ:

randomNumberOrigin - 各乱数値の起点(含む)

randomNumberBound - 各乱数値の境界(含まない)

戻り値:

それぞれ起点(含む)と境界(含まない)が指定された、擬似乱数long値のストリー�

スロー:

IllegalArgumentException - randomNumberOriginがrandomNumberBound以上の� �合

導入されたバージョン:

1.8

doubles

public DoubleStream doubles(long streamSize)

0(含む)から1(含まない)までの擬似乱数double値を、指定されたstreamSize数� け生成するストリー� を返します。

メソッドRandom.nextDouble()をコールした結果として、擬似乱数double値が生成されます。

定義:

インタフェースRandomGenerator内のdoubles

オーバーライド:

doubles、クラスRandom

パラメータ:

streamSize - 生成する値の数

戻り値:

double値のストリー�

スロー:

IllegalArgumentException - streamSizeが0未満の� �合

導入されたバージョン:

1.8

doubles

public DoubleStream doubles()

0(含む)から1(含まない)までの擬似乱数 double値を含む、事実上無制限のストリー� を返します。

メソッドRandom.nextDouble()をコールした結果として、擬似乱数double値が生成されます。

定義:

インタフェースRandomGenerator内のdoubles

オーバーライド:

doubles、クラスRandom

実装上のノート:

このメソッドは、doubles(Long.MAX_VALUE)と同等であるように実装されます。

戻り値:

擬似乱数double値のストリー�

導入されたバージョン:

1.8

doubles

public DoubleStream doubles(long streamSize, double randomNumberOrigin, double randomNumberBound)

指定された起点(含む)と境界(含まない)に準� した擬似乱数double値を、指定されたstreamSize数� け生成するストリー� を返します。

定義:

インタフェースRandomGenerator内のdoubles

オーバーライド:

doubles、クラスRandom

パラメータ:

streamSize - 生成する値の数

randomNumberOrigin - 各乱数値の起点(含む)

randomNumberBound - 各乱数値の境界(含まない)

戻り値:

それぞれ起点(含む)と限界(含まない)が指定された、擬似乱数double値のストリー�

スロー:

IllegalArgumentException - streamSizeがゼロ未満またはrandomNumberOriginが有限でない� �合、またはrandomNumberBoundが有限でない� �合、またはrandomNumberOriginがrandomNumberBound以上である� �合

導入されたバージョン:

1.8

doubles

public DoubleStream doubles(double randomNumberOrigin, double randomNumberBound)

指定された起点(含む)と境界(含まない)に準� した擬似乱数 double値を含む、事実上無制限のストリー� を返します。

定義:

インタフェースRandomGenerator内のdoubles

オーバーライド:

doubles、クラスRandom

実装上のノート:

このメソッドは、doubles(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound)と同等であるように実装されます。

パラメータ:

randomNumberOrigin - 各乱数値の起点(含む)

randomNumberBound - 各乱数値の境界(含まない)

戻り値:

それぞれ起点(含む)と限界(含まない)が指定された、擬似乱数double値のストリー�

スロー:

IllegalArgumentException - randomNumberOriginが有限でない� �合、またはrandomNumberBoundが有限でない� �合、またはrandomNumberOriginがrandomNumberBound以上である� �合

導入されたバージョン:

1.8