Класс SplittableRandom

java.lang.Object

java.util.SplittableRandom

Все реализованные интерфейсы:: RandomGenerator, RandomGenerator.SplittableGenerator, RandomGenerator.StreamableGenerator

public final class SplittableRandom extends Object implements RandomGenerator, RandomGenerator.SplittableGenerator

Генератор равномерных псевдослучайных значений (с периодом 2⁶⁴), применимый, в том числе, для изолированных параллельных вычислений, которые могут генерировать подзадачи. Класс SplittableRandom поддерживает методы для получения псевдослучайных чисел типа int, long, и double с аналогичными способами использования, как и для класса Random, но отличается следующими способами:

Последовательности сгенерированных значений проходят проверку набора DieHarder на независимость и равномерность свойств генераторов псевдослучайных чисел. (В последний раз проверка проводилась с помощью версии 3.31.1 .) Эти тесты проверяют только методы для определённых типов и диапазонов, но аналогичные свойства, по крайней мере приблизительно, ожидаются и для других. Период (длина любой последовательности сгенерированных значений перед её повторением) составляет 2⁶⁴.
Метод split() создаёт и возвращает новый экземпляр SplittableRandom, который не имеет общего изменяемого состояния с текущим экземпляром. Однако с очень высокой вероятностью значения, сгенерированные двумя объектами, обладают такими же статистическими свойствами, как если бы такое же количество значений было сгенерировано одним потоком с использованием одного объекта SplittableRandom.
Экземпляры SplittableRandom не потокобезопасны. Они предназначены для разделения, а не совместного использования, между потоками. Например, вычисление fork/join-style с использованием случайных чисел может включать создание структуры вида new Subtask(aSplittableRandom.split()).fork().
Этот класс предоставляет дополнительные методы для генерации потоков случайных чисел, которые используют вышеупомянутые методы, когда используется режим stream.parallel().

Экземпляры SplittableRandom не являются криптографически безопасными. Вместо этого используйте SecureRandom в приложениях, чувствительных к безопасности. Кроме того, экземпляры, созданные по умолчанию, не используют криптографически случайное значение, если системная переменная java.util.secureRandomSeed не установлена в значение true.

С:: 1.8

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.random.RandomGenerator

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

Краткое описание конструкторов

Конструктор Описание

Конструктор	Описание
`SplittableRandom()`	Создаёт новый экземпляр SplittableRandom, который, вероятно, сгенерирует последовательности значений, статистически независимые от последовательностей других экземпляров в текущей программе; и может, и обычно, меняться при повторных запусках программы.
`SplittableRandom(long seed)`	Создаёт новый экземпляр SplittableRandom с использованием указанного начального значения.

SplittableRandom()

Создаёт новый экземпляр SplittableRandom, который, вероятно, сгенерирует последовательности значений, статистически независимые от последовательностей других экземпляров в текущей программе; и может, и обычно, меняться при повторных запусках программы.

SplittableRandom(long seed)

Создаёт новый экземпляр SplittableRandom с использованием указанного начального значения.

Краткое описание методов

Модификатор и тип	Метод	Описание
`DoubleStream`	`doubles()`	Возвращает эффективно неограниченный поток псевдослучайных значений `double` от этого генератора и/или одного разделения от него; каждое значение находится в диапазоне от нуля (включительно) до единицы (исключительно).
`DoubleStream`	`doubles(double randomNumberOrigin, double randomNumberBound)`	Возвращает эффективно неограниченный поток псевдослучайных значений `double` от этого генератора и/или одного разделения от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).
`DoubleStream`	`doubles(long streamSize)`	Возвращает поток, генерирующий заданное количество `streamSize` псевдослучайных значений `double` от этого генератора и/или одного разделения от него; каждое значение находится в диапазоне от нуля (включительно) до единицы (исключительно).
`DoubleStream`	`doubles(long streamSize, double randomNumberOrigin, double randomNumberBound)`	Возвращает поток, генерирующий заданное количество `streamSize` псевдослучайных значений `double` от этого генератора и/или одного разделения от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).
`IntStream`	`ints()`	Возвращает эффективно неограниченный поток псевдослучайных значений `int` от этого генератора и/или одного разделения от него.
`IntStream`	`ints(int randomNumberOrigin, int randomNumberBound)`	Возвращает эффективно неограниченный поток псевдослучайных значений `int` от этого генератора и/или одного разделения от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).
`IntStream`	`ints(long streamSize)`	Возвращает поток, генерирующий заданное количество `streamSize` псевдослучайных значений `int` от этого генератора и/или одного разделения от него.
`IntStream`	`ints(long streamSize, int randomNumberOrigin, int randomNumberBound)`	Возвращает поток, генерирующий заданное количество `streamSize` псевдослучайных значений `int` от этого генератора и/или одного разделения от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).
`LongStream`	`longs()`	Возвращает эффективно неограниченный поток псевдослучайных значений `long` от этого генератора и/или одного разделения от него.
`LongStream`	`longs(long streamSize)`	Возвращает поток, генерирующий заданное количество `streamSize` псевдослучайных значений `long` от этого генератора и/или одного разделения от него.
`LongStream`	`longs(long randomNumberOrigin, long randomNumberBound)`	Возвращает эффективно неограниченный поток псевдослучайных значений `long` от этого генератора и/или одного разделения от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).
`LongStream`	`longs(long streamSize, long randomNumberOrigin, long randomNumberBound)`	Возвращает поток, генерирующий заданное количество `streamSize` псевдослучайных значений `long` от этого генератора и/или одного разделения от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).
`void`	`nextBytes(byte[] bytes)`	Заполняет предоставленный пользователем массив байтов сгенерированными байтовыми значениями, псевдослучайно выбранными равномерно из диапазона значений между -128 (включительно) и 127 (включительно).
`long`	`nextLong()`	Возвращает псевдослучайно выбранное значение `long`.
`SplittableRandom`	`split()`	Создаёт и возвращает новый экземпляр SplittableRandom, который не имеет общего изменяемого состояния с этим экземпляром.
`SplittableRandom`	`split(RandomGenerator.SplittableGenerator source)`	Возвращает новый генератор псевдослучайных чисел, отделённый от этого, который реализует интерфейсы `RandomGenerator` и `RandomGenerator.SplittableGenerator`.
`Stream<RandomGenerator.SplittableGenerator>`	`splits()`	Возвращает эффективно неограниченный поток новых генераторов псевдослучайных чисел, каждый из которых реализует интерфейс `RandomGenerator.SplittableGenerator`.
`Stream<RandomGenerator.SplittableGenerator>`	`splits(long streamSize)`	Возвращает поток, генерирующий заданное количество `streamSize` новых генераторов псевдослучайных чисел, каждый из которых реализует интерфейс `RandomGenerator.SplittableGenerator`.
`Stream<RandomGenerator.SplittableGenerator>`	`splits(long streamSize, RandomGenerator.SplittableGenerator source)`	Возвращает поток, генерирующий заданное количество `streamSize` новых генераторов псевдослучайных чисел, каждый из которых реализует интерфейс `RandomGenerator.SplittableGenerator`.
`Stream<RandomGenerator.SplittableGenerator>`	`splits(RandomGenerator.SplittableGenerator source)`	Возвращает эффективно неограниченный поток новых генераторов псевдослучайных чисел, каждый из которых реализует интерфейс `RandomGenerator.SplittableGenerator`.

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе java.util.random.RandomGenerator

isDeprecated, nextBoolean, nextDouble, nextDouble, nextDouble, nextExponential, nextFloat, nextFloat, nextFloat, nextGaussian, nextGaussian, nextInt, nextInt, nextInt, nextLong, nextLong

Методы, объявленные в интерфейсе java.util.random.RandomGenerator.SplittableGenerator

rngs, rngs

Краткое описание конструкторов

SplittableRandom

public SplittableRandom(long seed)

Создает новый экземпляр SplittableRandom, используя указанное начальное seed. Экземпляры SplittableRandom, созданные с одним и тем же seed в одной и той же программе, генерируют идентичные последовательности значений.

Параметры:: seed - начальное seed

SplittableRandom

public SplittableRandom()

Создает новый экземпляр SplittableRandom, который, вероятно, будет генерировать последовательности значений, статистически независимые от последовательностей любых других экземпляров в текущей программе; и может, и обычно изменяется между вызовами программы.

Краткое описание методов

split

public SplittableRandom split()

Конструирует и возвращает новый экземпляр SplittableRandom, который не имеет общего изменяемого состояния с этим экземпляром. Однако, с очень высокой вероятностью, набор значений, генерируемых совместно двумя объектами, имеет те же статистические свойства, как если бы то же количество значений было сгенерировано одним потоком с использованием одного объекта SplittableRandom. Любой или оба из двух объектов могут быть дополнительно разделены с помощью метода split(), и те же ожидаемые статистические свойства применяются ко всему набору генераторов, созданных таким рекурсивным разделением.

Указано в:: split в интерфейсе RandomGenerator.SplittableGenerator
Возвращает:: новый экземпляр SplittableRandom

split

public SplittableRandom split(RandomGenerator.SplittableGenerator source)

Возвращает новый генератор псевдослучайных чисел, отделенный от этого, который реализует интерфейсы RandomGenerator и RandomGenerator.SplittableGenerator.

Указано в:: split в интерфейсе RandomGenerator.SplittableGenerator
Параметры:: source - экземпляр RandomGenerator.SplittableGenerator, который будет использоваться вместо этого в качестве источника псевдослучайных битов, используемых для инициализации состояния новых.
Возвращает:: объект, реализующий интерфейсы RandomGenerator и RandomGenerator.SplittableGenerator
Исключения:: NullPointerException - если source равен null
С версии:: 17

nextLong

public long nextLong()

Описание скопировано из интерфейса: RandomGenerator

Возвращает псевдослучайно выбранное значение long.

Указано в:: nextLong в интерфейсе RandomGenerator
Возвращает:: псевдослучайно выбранное значение long

nextBytes

public void nextBytes(byte[] bytes)

Заполняет предоставленный пользователем массив байтов сгенерированными значениями байтов, псевдослучайно выбранными равномерно из диапазона значений от -128 (включительно) до 127 (включительно).

Указано в:: nextBytes в интерфейсе RandomGenerator
Параметры:: bytes - массив байтов для заполнения псевдослучайными байтами
Исключения:: NullPointerException - если bytes равен null
С версии:: 10

splits

public Stream<RandomGenerator.SplittableGenerator> splits()

Возвращает эффективно неограниченный поток новых генераторов псевдослучайных чисел, каждый из которых реализует интерфейс RandomGenerator.SplittableGenerator.

Этот генератор псевдослучайных чисел может использоваться в качестве источника псевдослучайных битов, используемых для инициализации состояния новых.

Указано в:: splits в интерфейсе RandomGenerator.SplittableGenerator
Требования к реализации:: Реализация по умолчанию вызывает splits(this).
Возвращает:: поток объектов RandomGenerator.SplittableGenerator
С версии:: 17

splits

public Stream<RandomGenerator.SplittableGenerator> splits(long streamSize)

Возвращает поток, генерирующий указанное streamSize число новых генераторов псевдослучайных чисел, каждый из которых реализует интерфейс RandomGenerator.SplittableGenerator.

Указано в:: splits в интерфейсе RandomGenerator.SplittableGenerator
Требования к реализации:
Параметры:: streamSize - количество значений для генерации
Возвращает:: поток объектов RandomGenerator.SplittableGenerator
Исключения:: IllegalArgumentException - если streamSize меньше нуля
С версии:: 17

splits

public Stream<RandomGenerator.SplittableGenerator> splits(RandomGenerator.SplittableGenerator source)

Указано в:: splits в интерфейсе RandomGenerator.SplittableGenerator
Требования к реализации:
Параметры:: source - экземпляр RandomGenerator.SplittableGenerator, который будет использоваться вместо этого в качестве источника псевдослучайных битов, используемых для инициализации состояния новых.
Возвращает:: поток объектов RandomGenerator.SplittableGenerator
Исключения:: NullPointerException - если source равен null
С версии:: 17

splits

public Stream<RandomGenerator.SplittableGenerator> splits(long streamSize, RandomGenerator.SplittableGenerator source)

Указано в:: splits в интерфейсе RandomGenerator.SplittableGenerator
Требования к реализации:
Параметры:: streamSize - количество значений для генерации; source - экземпляр RandomGenerator.SplittableGenerator, который будет использоваться вместо этого в качестве источника псевдослучайных битов, используемых для инициализации состояния новых.
Возвращает:: поток объектов RandomGenerator.SplittableGenerator
Исключения:: NullPointerException - если source равен null; IllegalArgumentException - если streamSize меньше нуля
С версии:: 17

ints

public IntStream ints(long streamSize)

Возвращает поток, генерирующий указанное streamSize число псевдослучайных значений int из этого генератора и/или одного, разделенного от него.

Указано в:: ints в интерфейсе RandomGenerator
Параметры:: streamSize - количество значений для генерации
Возвращает:: поток псевдослучайных значений int
Исключения:: IllegalArgumentException - если streamSize меньше нуля

ints

public IntStream ints()

Возвращает эффективно неограниченный поток псевдослучайных значений int из этого генератора и/или одного, разделенного от него.

Указано в:: ints в интерфейсе RandomGenerator
Примечание к реализации:: Этот метод реализован как эквивалент ints(Long.MAX_VALUE).
Возвращает:: поток псевдослучайных значений int

ints

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

Возвращает поток, генерирующий указанное streamSize число псевдослучайных значений int из этого генератора и/или одного, разделенного от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).

Указано в:: ints в интерфейсе RandomGenerator
Параметры:: streamSize - количество значений для генерации; randomNumberOrigin - начало (включительно) каждого случайного значения; randomNumberBound - граница (исключительно) каждого случайного значения
Возвращает:: поток псевдослучайных значений int, каждое с заданным началом (включительно) и границей (исключительно)
Исключения:: IllegalArgumentException - если streamSize меньше нуля, или randomNumberOrigin больше или равно randomNumberBound

ints

public IntStream ints(int randomNumberOrigin, int randomNumberBound)

Возвращает эффективно неограниченный поток псевдослучайных

int

значений из этого генератора и/или одного из разделенных от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).

Указано:: ints в интерфейсе RandomGenerator
Примечание реализации:: Этот метод реализован так, чтобы быть эквивалентным ints(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).
Параметры:: randomNumberOrigin - начало (включительно) каждого случайного значения; randomNumberBound - граница (исключительно) каждого случайного значения
Возвращает:: поток псевдослучайных int значений, каждое из которых имеет заданное начало (включительно) и границу (исключительно)
Выбрасывает:: IllegalArgumentException - если randomNumberOrigin больше или равно randomNumberBound

longs

public LongStream longs(long streamSize)

Возвращает поток, производящий заданное количество streamSize псевдослучайных long значений из этого генератора и/или одного из разделенных от него.

Указано:: longs в интерфейсе RandomGenerator
Параметры:: streamSize - количество значений для генерации
Возвращает:: поток псевдослучайных long значений
Выбрасывает:: IllegalArgumentException - если streamSize меньше нуля

longs

public LongStream longs()

Возвращает эффективно неограниченный поток псевдослучайных


 long

значений из этого генератора и/или одного из разделенных от него.

Указано:: longs в интерфейсе RandomGenerator
Примечание реализации:: Этот метод реализован так, чтобы быть эквивалентным longs(Long.MAX_VALUE).
Возвращает:: поток псевдослучайных long значений

longs

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

Возвращает поток, производящий заданное streamSize количество псевдослучайных long значений из этого генератора и/или одного из разделенных от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).

Указано:: longs в интерфейсе RandomGenerator
Параметры:: streamSize - количество значений для генерации; randomNumberOrigin - начало (включительно) каждого случайного значения; randomNumberBound - граница (исключительно) каждого случайного значения
Возвращает:: поток псевдослучайных long значений, каждое из которых имеет заданное начало (включительно) и границу (исключительно)
Выбрасывает:: IllegalArgumentException - если streamSize меньше нуля, или randomNumberOrigin больше или равно randomNumberBound

longs

public LongStream longs(long randomNumberOrigin, long randomNumberBound)

Возвращает эффективно неограниченный поток псевдослучайных


 long

Указано:: longs в интерфейсе RandomGenerator
Примечание реализации:: Этот метод реализован так, чтобы быть эквивалентным longs(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).
Параметры:: randomNumberOrigin - начало (включительно) каждого случайного значения; randomNumberBound - граница (исключительно) каждого случайного значения
Возвращает:: поток псевдослучайных long значений, каждое из которых имеет заданное начало (включительно) и границу (исключительно)
Выбрасывает:: IllegalArgumentException - если randomNumberOrigin больше или равно randomNumberBound

doubles

public DoubleStream doubles(long streamSize)

Возвращает поток, производящий заданное streamSize количество псевдослучайных double значений из этого генератора и/или одного из разделенных от него; каждое значение находится между нулём (включительно) и единицей (исключительно).

Указано:: doubles в интерфейсе RandomGenerator
Параметры:: streamSize - количество значений для генерации
Возвращает:: поток double значений
Выбрасывает:: IllegalArgumentException - если streamSize меньше нуля

doubles

public DoubleStream doubles()

Возвращает эффективно неограниченный поток псевдослучайных


 double

значений из этого генератора и/или одного из разделенных от него; каждое значение находится между нулём (включительно) и единицей (исключительно).

Указано:: doubles в интерфейсе RandomGenerator
Примечание реализации:: Этот метод реализован так, чтобы быть эквивалентным doubles(Long.MAX_VALUE).
Возвращает:: поток псевдослучайных double значений

doubles

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

Возвращает поток, производящий заданное streamSize количество псевдослучайных double значений из этого генератора и/или одного из разделенных от него; каждое значение соответствует заданному началу (включительно) и границе (исключительно).

Указано:: doubles в интерфейсе RandomGenerator
Параметры:: streamSize - количество значений для генерации; randomNumberOrigin - начало (включительно) каждого случайного значения; randomNumberBound - граница (исключительно) каждого случайного значения
Возвращает:: поток псевдослучайных double значений, каждое из которых имеет заданное начало (включительно) и границу (исключительно)
Выбрасывает:: IllegalArgumentException - если streamSize меньше нуля, или randomNumberOrigin больше или равно randomNumberBound

doubles

public DoubleStream doubles(double randomNumberOrigin, double randomNumberBound)

Возвращает эффективно неограниченный поток псевдослучайных


 double

Указано:: doubles в интерфейсе RandomGenerator
Примечание реализации:: Этот метод реализован так, чтобы быть эквивалентным doubles(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).
Параметры:: randomNumberOrigin - начало (включительно) каждого случайного значения; randomNumberBound - граница (исключительно) каждого случайного значения
Возвращает:: поток псевдослучайных double значений, каждое из которых имеет заданное начало (включительно) и границу (исключительно)
Выбрасывает:: IllegalArgumentException - если randomNumberOrigin больше или равно randomNumberBound

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/SplittableRandom.html