Интерфейс RandomGenerator

static RandomGenerator of(String name)

Параметры:

name — название алгоритма генератора случайных чисел

Возвращает:

экземпляр RandomGenerator

Выбрасывает:

NullPointerException — если имя равно null

IllegalArgumentException — если алгоритм с указанным именем не найден

static RandomGenerator getDefault()

Требования к реализации:

Поскольку алгоритмы со временем совершенствуются, нет гарантии, что этот метод будет возвращать один и тот же алгоритм.

Реализация по умолчанию выбирает L32X64MixRandom.

Возвращает:

RandomGenerator

default boolean isDeprecated()

Требования к реализации:

Реализация по умолчанию проверяет наличие аннотации @Deprecated.

Примечание по реализации:

Алгоритмы генерации случайных чисел со временем развиваются: появляются новые алгоритмы, а старые теряют актуальность. Если более старый алгоритм признаётся непригодным для дальнейшего использования, он помечается как устаревший, что указывает на возможность его удаления в будущем.

Возвращает:

true, если реализация RandomGenerator (алгоритм) помечена как устаревшая

default DoubleStream doubles()

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextDouble().

Примечание по реализации:

Допускается реализовать этот метод способом, эквивалентным вызову doubles (Long.MAX_VALUE).

Возвращает:

поток псевдослучайно выбранных значений double

default DoubleStream doubles(double randomNumberOrigin, double randomNumberBound)

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextDouble(randomNumberOrigin, randomNumberBound).

Примечание по реализации:

Допускается реализовать этот метод способом, эквивалентным вызову doubles (Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Параметры:

randomNumberOrigin — наименьшее возможное значение

randomNumberBound — верхняя граница (не включительно) для каждого генерируемого значения

Возвращает:

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

Выбрасывает:

IllegalArgumentException — если randomNumberOrigin не является конечным, или randomNumberBound не является конечным, или randomNumberOrigin больше или равно randomNumberBound

default DoubleStream doubles(long streamSize)

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextDouble().

Параметры:

streamSize — количество генерируемых значений

Возвращает:

поток псевдослучайно выбранных значений double

Выбрасывает:

IllegalArgumentException — если streamSize меньше нуля

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

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextDouble(randomNumberOrigin, randomNumberBound).

Параметры:

streamSize — количество генерируемых значений

randomNumberOrigin — наименьшее возможное значение

randomNumberBound — верхняя граница (не включительно) для каждого генерируемого значения

Возвращает:

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

Выбрасывает:

IllegalArgumentException — если streamSize меньше нуля, или randomNumberOrigin не является конечным, или randomNumberBound не является конечным, или randomNumberOrigin больше или равно randomNumberBound

default DoubleStream equiDoubles(double left, double right, boolean isLeftIncluded, boolean isRightIncluded)

Требования к реализации:

Реализация по умолчанию сначала определяет указанное выше значение δ. Затем она вычисляет наименьшее целое число k_l, для которого k_l δ находится внутри заданного интервала, и наименьшее целое число n > 0, для которого (k_l + n) δ находится вне интервала. Наконец, метод возвращает поток, генерирующий значения double по формуле (k_l + nextLong(n)) δ. Поток никогда не генерирует -0.0, однако может генерировать 0.0, если указанный интервал содержит 0.

Параметры:

left — левая граница

right — правая граница

isLeftIncluded — указывает, включена ли left граница

isRightIncluded — указывает, включена ли right граница

Возвращает:

поток псевдослучайно выбранных значений double, каждое из которых находится между left и right, как описано выше.

Выбрасывает:

IllegalArgumentException — если left не является конечным, или right не является конечным, или указанный интервал пуст.

С версии:

22

default IntStream ints()

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextInt().

Примечание по реализации:

Допускается реализовать этот метод способом, эквивалентным вызову ints (Long.MAX_VALUE).

Возвращает:

поток псевдослучайно выбранных значений int

default IntStream ints(int randomNumberOrigin, int randomNumberBound)

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextInt(randomNumberOrigin, randomNumberBound).

Примечание по реализации:

Допускается реализовать этот метод способом, эквивалентным вызову ints (Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Параметры:

randomNumberOrigin — наименьшее возможное значение

randomNumberBound — верхняя граница (не включительно) для каждого генерируемого значения

Возвращает:

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

Выбрасывает:

IllegalArgumentException — если randomNumberOrigin больше или равно randomNumberBound

default IntStream ints(long streamSize)

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextInt().

Параметры:

streamSize — количество генерируемых значений

Возвращает:

поток псевдослучайно выбранных значений int

Выбрасывает:

IllegalArgumentException — если streamSize меньше нуля

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

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextInt(randomNumberOrigin, randomNumberBound).

Параметры:

streamSize — количество генерируемых значений

randomNumberOrigin — наименьшее возможное значение

randomNumberBound — верхняя граница (не включительно) для каждого генерируемого значения

Возвращает:

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

Выбрасывает:

IllegalArgumentException — если streamSize меньше нуля или randomNumberOrigin больше или равно randomNumberBound

default LongStream longs()

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextLong().

Примечание по реализации:

Допускается реализовать этот метод способом, эквивалентным вызову longs (Long.MAX_VALUE).

Возвращает:

поток псевдослучайно выбранных значений long

default LongStream longs(long randomNumberOrigin, long randomNumberBound)

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextLong(randomNumberOrigin, randomNumberBound).

Примечание по реализации:

Допускается реализовать этот метод способом, эквивалентным вызову longs (Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Параметры:

randomNumberOrigin — наименьшее возможное значение

randomNumberBound — верхняя граница (не включительно) для каждого генерируемого значения

Возвращает:

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

Выбрасывает:

IllegalArgumentException — если randomNumberOrigin больше или равно randomNumberBound

default LongStream longs(long streamSize)

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextLong().

Параметры:

streamSize — количество генерируемых значений

Возвращает:

поток псевдослучайно выбранных значений long

Выбрасывает:

IllegalArgumentException — если streamSize меньше нуля

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

Требования к реализации:

Реализация по умолчанию создаёт последовательный поток, многократно вызывающий nextLong(randomNumberOrigin, randomNumberBound).

Параметры:

streamSize — количество генерируемых значений

randomNumberOrigin — наименьшее возможное значение

randomNumberBound — верхняя граница (не включительно) для каждого генерируемого значения

Возвращает:

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

Выбрасывает:

IllegalArgumentException — если streamSize меньше нуля или randomNumberOrigin больше или равно randomNumberBound

default boolean nextBoolean()

Требования к реализации:

Реализация по умолчанию формирует результат на основе бита знака числа, сгенерированного вызовом nextInt().

Возвращает:

псевдослучайно выбранное значение boolean

default void nextBytes(byte[] bytes)

Требования к реализации:

Реализация по умолчанию получает результаты посредством многократных вызовов nextLong().

Примечание по реализации:

Алгоритм заполнения байтового массива;

          void nextBytes(byte[] bytes) {
              int i = 0;
              int len = bytes.length;
              for (int words = len >> 3; words--> 0; ) {
                  long rnd = nextLong();
                  for (int n = 8; n--> 0; rnd >>>= Byte.SIZE)
                      bytes[i++] = (byte)rnd;
              }
              if (i < len)
                  for (long rnd = nextLong(); i < len; rnd >>>= Byte.SIZE)
                      bytes[i++] = (byte)rnd;
          }

Параметры:

bytes — байтовый массив для заполнения псевдослучайными байтами

Выбрасывает:

NullPointerException — если bytes равен null

default float nextFloat()

Требования к реализации:

Реализация по умолчанию использует Float.PRECISION старших битов из результата вызова nextInt().

Возвращает:

псевдослучайное значение float в диапазоне от нуля (включительно) до единицы (не включительно)

default float nextFloat(float bound)

Требования к реализации:

Реализация по умолчанию проверяет, что bound является положительным конечным числом типа float. Затем вызывает nextFloat() и масштабирует результат так, чтобы итоговое значение находилось в диапазоне от 0.0f (включительно) до bound (не включительно).

Параметры:

bound — верхняя граница (не включительно) возвращаемого значения. Должна быть положительной и конечной

Возвращает:

псевдослучайно выбранное значение float в диапазоне от нуля (включительно) до указанной верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если bound не является одновременно положительным и конечным

default float nextFloat(float origin, float bound)

Требования к реализации:

Реализация по умолчанию проверяет допустимость значений origin и bound, затем вызывает nextFloat(), масштабируя и смещая результат так, чтобы он находился между origin и bound (не включительно).

Параметры:

origin — наименьшее возвращаемое значение

bound — верхняя граница (не включительно)

Возвращает:

псевдослучайно выбранное значение float в диапазоне от начального значения (включительно) до верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если origin не является конечным, или bound не является конечным, или origin больше или равно bound

default double nextDouble()

Требования к реализации:

Реализация по умолчанию использует Double.PRECISION старших битов из результата вызова nextLong().

Возвращает:

псевдослучайное значение double в диапазоне от нуля (включительно) до единицы (не включительно)

default double nextDouble(double bound)

Требования к реализации:

Реализация по умолчанию проверяет, что bound является положительным конечным числом типа double. Затем вызывает nextDouble() и масштабирует результат так, чтобы итоговое значение находилось в диапазоне от 0.0 (включительно) до bound (не включительно).

Параметры:

bound — верхняя граница (не включительно) возвращаемого значения. Должна быть положительной и конечной

Возвращает:

псевдослучайно выбранное значение double в диапазоне от нуля (включительно) до указанной верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если bound не является одновременно положительным и конечным

default double nextDouble(double origin, double bound)

Требования к реализации:

Реализация по умолчанию проверяет допустимость значений origin и bound, затем вызывает nextDouble(), масштабируя и смещая результат так, чтобы он находился между origin и bound (не включительно).

Параметры:

origin — наименьшее возвращаемое значение

bound — верхняя граница (не включительно) возвращаемого значения

Возвращает:

псевдослучайно выбранное значение double в диапазоне от начального значения (включительно) до верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если origin не является конечным, или bound не является конечным, или origin больше или равно bound

default int nextInt()

Требования к реализации:

Реализация по умолчанию использует 32 старших бита из результата вызова nextLong().

Возвращает:

псевдослучайно выбранное значение int

default int nextInt(int bound)

Требования к реализации:

Реализация по умолчанию проверяет, что bound положительно. Затем она один или несколько раз вызывает nextInt(), чтобы обеспечить равномерное распределение в диапазоне от 0 (включительно) до bound (не включительно). Предполагается, что распределение значений nextInt() равномерно.

Параметры:

bound — верхняя граница (не включительно) возвращаемого значения. Должна быть положительной.

Возвращает:

псевдослучайно выбранное значение int в диапазоне от нуля (включительно) до указанной верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если bound не является положительным

default int nextInt(int origin, int bound)

Требования к реализации:

Реализация по умолчанию проверяет, что origin меньше bound. Затем она один или несколько раз вызывает nextInt(), чтобы обеспечить равномерное распределение в диапазоне от origin (включительно) до bound (не включительно). Предполагается, что распределение значений nextInt() равномерно.

Параметры:

origin — наименьшее возвращаемое значение

bound — верхняя граница (не включительно) возвращаемого значения

Возвращает:

псевдослучайно выбранное значение int в диапазоне от начального значения (включительно) до верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если origin больше или равно bound

long nextLong()

Возвращает:

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

default long nextLong(long bound)

Требования к реализации:

Реализация по умолчанию проверяет, что bound положительно. Затем она один или несколько раз вызывает nextLong(), чтобы обеспечить равномерное распределение в диапазоне от 0 (включительно) до bound (не включительно). Предполагается, что распределение значений nextLong() равномерно.

Параметры:

bound — верхняя граница (не включительно) возвращаемого значения. Должна быть положительной.

Возвращает:

псевдослучайно выбранное значение long в диапазоне от нуля (включительно) до указанной верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если bound не является положительным

default long nextLong(long origin, long bound)

Требования к реализации:

Реализация по умолчанию проверяет, что origin меньше bound. Затем она один или несколько раз вызывает nextLong(), чтобы обеспечить равномерное распределение в диапазоне от origin (включительно) до bound (не включительно). Предполагается, что распределение значений nextLong() равномерно.

Параметры:

origin — наименьшее возвращаемое значение

bound — верхняя граница (не включительно) возвращаемого значения

Возвращает:

псевдослучайно выбранное значение long в диапазоне от начального значения (включительно) до верхней границы (не включительно)

Выбрасывает:

IllegalArgumentException — если origin больше или равно bound

default double nextGaussian()

Требования к реализации:

Реализация по умолчанию использует быстрый модифицированный алгоритм зиггурат Макфарланда (в основном табличный; редкие случаи обрабатываются вычислениями и выборкой с отклонением). Также применяется метод алиасов Уокера для выборки из дискретного распределения.

Возвращает:

значение double, псевдослучайно выбранное из гауссовского распределения

default double nextGaussian(double mean, double stddev)

Требования к реализации:

Реализация по умолчанию использует быстрый модифицированный алгоритм зиггура Макфарланда (в основном основанный на таблицах; редкие случаи обрабатываются с помощью вычислений и выборки с отбраковкой). Также используется метод алиасов Уокера для выборки из дискретного распределения.

Параметры:

mean — среднее значение гауссовского распределения, из которого производится выборка

stddev — стандартное отклонение (квадратный корень из дисперсии) гауссовского распределения, из которого производится выборка

Возвращает:

значение double, псевдослучайно выбранное из указанного гауссовского распределения

Вызывает исключение:

IllegalArgumentException — если stddev отрицательно

default double nextExponential()

Требования к реализации:

Реализация по умолчанию использует быстрый модифицированный алгоритм зиггура Макфарланда (в основном основанный на таблицах; редкие случаи обрабатываются с помощью вычислений и выборки с отбраковкой). Также используется метод алиасов Уокера для выборки из дискретного распределения.

Возвращает:

неотрицательное значение double, псевдослучайно выбранное из экспоненциального распределения