compact1, compact2, compact3

java.util

Class SplittableRandom

java.lang.Object

java.util.SplittableRandom

public final class SplittableRandom
extends Object

用于发电机的均匀分布的随机值（在其他情况下适用）分离的并行计算，可以生成任务。类 SplittableRandom支持生产型 int， long伪随机数的方法，并 double类似的用法作为课堂 Random但在以下方面有所不同：

• 生成的值序列通过dieharder套房独立检验和随机数发生器的均匀性。（最近的验证 version 3.31.1。）这些测试验证的方法对于某些类型和范围，但类似的性能预计将保持至少约，也为别人。期（前重复一系列生成的值的长度至少是2^六十四）。
• 方法split()构建并返回一个新的splittablerandom实例与当前实例的股票没有可变状态。然而，以很高的概率，由两个对象集体产生的值具有相同的统计特性，如果相同的价值量是通过使用一个单一的SplittableRandom单线程生成的对象。
• splittablerandom实例不是线程安全的。他们的设计是分裂的，不共享的，跨线程。例如，使用随机数fork/join-style计算可能包括的形式new Subtask(aSplittableRandom.split()).fork()建设。
• 这个类提供了用于生成随机流的附加方法，采用以上技术的使用时，stream.parallel()模式。

实例SplittableRandom不加密的安全。考虑安全敏感的应用，而不是使用SecureRandom。另外，默认情况下不使用加密的随机种子除非system property java.util.secureRandomSeed设置true。

从以下版本开始：

一点八

构造方法摘要

构造方法

Constructor and Description
SplittableRandom() 创建一个新的splittablerandom实例，很可能产生，是统计独立的，那些在当前程序的任何其他实例的值序列；也许，通常，在程序调用不同。
SplittableRandom(long seed) 使用指定的初始种子创建一个新的splittablerandom实例。

方法摘要

Modifier and Type	Method and Description
DoubleStream	doubles() 返回从发电机和/或从这一分裂的伪随机 double值有效的无限流；每个值在零（含）和一个（独家）。
DoubleStream	doubles(double randomNumberOrigin, double randomNumberBound) 返回从发电机和/或从这一分裂的伪随机 double值有效的无限流；每个值符合给定的起源（含）和绑定（独家）。
DoubleStream	doubles(long streamSize) 返回一个流从发电机和/或从这一分裂产生伪随机 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数；每个值符合给定的起源（含）和绑定（独家）。
boolean	nextBoolean() 返回一个随机 boolean价值。
double	nextDouble() 返回一个零之间的伪随机 double值（含）和一个（独家）。
double	nextDouble(double bound) 返回一个0值之间的伪随机 double（含）和指定的绑定（独家）。
double	nextDouble(double origin, double bound) 返回一个指定的起点之间的伪随机 double值（含）和绑定（独家）。
int	nextInt() 返回一个随机 int价值。
int	nextInt(int bound) 返回一个零之间的伪随机 int值（含）与指定的绑定（独家）。
int	nextInt(int origin, int bound) 返回一个指定的起点之间的伪随机 int值（含）与指定的绑定（独家）。
long	nextLong() 返回一个随机 long价值。
long	nextLong(long bound) 返回一个零之间的伪随机 long值（含）与指定的绑定（独家）。
long	nextLong(long origin, long bound) 返回一个指定的起点之间的伪随机 long值（含）与指定的绑定（独家）。
SplittableRandom	split() 构建并返回一个新实例，该实例splittablerandom股份没有可变状态。

Methods inherited from class java.lang.Object

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

Constructor Detail

SplittableRandom

public SplittableRandom(long seed)

使用指定的初始种子创建一个新的splittablerandom实例。splittablerandom实例在同一个程序中创建相同的种子产生的值相同的序列。

参数

seed -最初的种子

SplittableRandom

public SplittableRandom()

创建一个新的splittablerandom实例，很可能产生，是统计独立的，那些在当前程序的任何其他实例的值序列；也许，通常，在程序调用不同。

方法详细信息

split

public SplittableRandom split()

构建并返回一个新实例，该实例splittablerandom股份没有可变状态。然而，以很高的概率，由两个对象集体产生值的集合如果值相同的数量是通过使用一个单一的splittablerandom对象单线程的产生具有相同的统计特性。两个对象中的一方或双方可以进一步分割使用 split()方法和相同的预期的统计特性，适用于这样的递归分割构造发电机整定。

结果

新splittablerandom实例

nextInt

public int nextInt()

返回一个随机 int价值。

结果

伪随机 int价值

nextInt

public int nextInt(int bound)

返回一个零之间的伪随机 int值（含）与指定的绑定（独家）。

参数

bound -上限（独家）。必须是积极的。

结果

一个零之间的伪随机 int值（含）和束缚（独家）

异常

IllegalArgumentException -如果 bound不积极

nextInt

public int nextInt(int origin,
                   int bound)

返回一个指定的起点之间的伪随机 int值（含）与指定的绑定（独家）。

参数

origin -最小值返回

bound -上限（独家）

结果

之间的伪随机 int起源价值（含）和束缚（独家）

异常

IllegalArgumentException -如果 origin大于或等于 bound

nextLong

public long nextLong()

返回一个随机 long价值。

结果

伪随机 long价值

nextLong

public long nextLong(long bound)

返回一个零之间的伪随机 long值（含）与指定的绑定（独家）。

参数

bound -上限（独家）。必须是积极的。

结果

一个零之间的伪随机 long值（含）和束缚（独家）

异常

IllegalArgumentException -如果 bound不积极

nextLong

public long nextLong(long origin,
                     long bound)

返回一个指定的起点之间的伪随机 long值（含）与指定的绑定（独家）。

参数

origin -最小值返回

bound -上限（独家）

结果

之间的伪随机 long起源价值（含）和束缚（独家）

异常

IllegalArgumentException -如果 origin大于或等于 bound

nextDouble

public double nextDouble()

返回一个零之间的伪随机 double值（含）和一个（独家）。

结果

一个零之间的伪随机 double价值（含）和一个（独家）

nextDouble

public double nextDouble(double bound)

返回一个0值之间的伪随机 double（含）和指定的绑定（独家）。

参数

bound -上限（独家）。必须是积极的。

结果

一个零之间的伪随机 double值（含）和束缚（独家）

异常

IllegalArgumentException -如果 bound不积极

nextDouble

public double nextDouble(double origin,
                         double bound)

返回一个指定的起点之间的伪随机 double值（含）和绑定（独家）。

参数

origin -最小值返回

bound -上限（独家）

结果

之间的伪随机 double起源价值（含）和束缚（独家）

异常

IllegalArgumentException -如果 origin大于或等于 bound

nextBoolean

public boolean nextBoolean()

返回一个随机 boolean价值。

结果

伪随机 boolean价值

ints

public IntStream ints(long streamSize)

返回一个流产生伪随机 int值给定的 streamSize数从发电机和/或一个分裂的。

参数

streamSize -数量值生成

结果

一个流的伪随机 int值

异常

IllegalArgumentException -如果 streamSize小于零

ints

public IntStream ints()

从它返回这个发电机和/或一个分裂的伪随机 int值有效的无限流。

Implementation Note:

此方法的实施相当于 ints(Long.MAX_VALUE)。

结果

一个流的伪随机 int值

ints

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

返回一个流从发电机和/或从这一分裂产生伪随机 int值给定的 streamSize数；每个值符合给定的起源（含）和绑定（独家）。

参数

streamSize -数量值生成

randomNumberOrigin -起源（含）各随机值

randomNumberBound -束缚（独家）各随机值

结果

一个流的伪随机 int值，每个给定的起源（含）和绑定（独家）

异常

IllegalArgumentException -如果 streamSize小于零，或者 randomNumberOrigin大于或等于 randomNumberBound

ints

public IntStream ints(int randomNumberOrigin,
                      int randomNumberBound)

返回从发电机和/或从这一分裂的伪随机 int值有效的无限流；每个值符合给定的起源（含）和绑定（独家）。

Implementation Note:

此方法的实施相当于 ints(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound)。

参数

randomNumberOrigin -起源（含）各随机值

randomNumberBound -束缚（独家）各随机值

结果

一个流的伪随机 int值，每个给定的起源（含）和绑定（独家）

异常

IllegalArgumentException -如果 randomNumberOrigin大于或等于 randomNumberBound

longs

public LongStream longs(long streamSize)

返回一个流产生伪随机 long值给定的 streamSize数从发电机和/或一个分裂的。

参数

streamSize -数量值生成

结果

一个流的伪随机 long值

异常

IllegalArgumentException -如果 streamSize小于零

longs

public LongStream longs()

从它返回这个发电机和/或一个分裂的伪随机 long值有效的无限流。

Implementation Note:

此方法的实施相当于 longs(Long.MAX_VALUE)。

结果

一个流的伪随机 long值

longs

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

返回一个流从发电机和/或从这一分裂产生伪随机 long值给定的 streamSize数；每个值符合给定的起源（含）和绑定（独家）。

参数

streamSize -数量值生成

randomNumberOrigin -起源（含）各随机值

randomNumberBound -束缚（独家）各随机值

结果

一个流的伪随机 long值，每个给定的起源（含）和绑定（独家）

异常

IllegalArgumentException -如果 streamSize小于零，或者 randomNumberOrigin大于或等于 randomNumberBound

longs

public LongStream longs(long randomNumberOrigin,
                        long randomNumberBound)

返回从发电机和/或从这一分裂的伪随机 long值有效的无限流；每个值符合给定的起源（含）和绑定（独家）。

Implementation Note:

此方法的实施相当于 longs(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound)。

参数

randomNumberOrigin -起源（含）各随机值

randomNumberBound -束缚（独家）各随机值

结果

一个流的伪随机 long值，每个给定的起源（含）和绑定（独家）

异常

IllegalArgumentException -如果 randomNumberOrigin大于或等于 randomNumberBound

doubles

public DoubleStream doubles(long streamSize)

返回一个流从发电机和/或从这一分裂产生伪随机 double值给定的 streamSize数；每个值在零（含）和一个（独家）。

参数

streamSize -数量值生成

结果

一股 double值

异常

IllegalArgumentException -如果 streamSize小于零

doubles

public DoubleStream doubles()

返回从发电机和/或从这一分裂的伪随机 double值有效的无限流；每个值在零（含）和一个（独家）。

Implementation Note:

此方法的实施相当于 doubles(Long.MAX_VALUE)。

结果

一个流的伪随机 double值

doubles

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

返回一个流从发电机和/或从这一分裂产生伪随机 double值给定的 streamSize数；每个值符合给定的起源（含）和绑定（独家）。

参数

streamSize -数量值生成

randomNumberOrigin -起源（含）各随机值

randomNumberBound -束缚（独家）各随机值

结果

一个流的伪随机 double值，每个给定的起源（含）和绑定（独家）

异常

IllegalArgumentException -如果 streamSize小于零

IllegalArgumentException -如果 randomNumberOrigin大于或等于 randomNumberBound

doubles

public DoubleStream doubles(double randomNumberOrigin,
                            double randomNumberBound)

返回从发电机和/或从这一分裂的伪随机 double值有效的无限流；每个值符合给定的起源（含）和绑定（独家）。

Implementation Note:

此方法的实施相当于 doubles(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound)。

参数

randomNumberOrigin -起源（含）各随机值

randomNumberBound -束缚（独家）各随机值

结果

一个流的伪随机 double值，每个给定的起源（含）和绑定（独家）

异常

IllegalArgumentException -如果 randomNumberOrigin大于或等于 randomNumberBound