Интерфейс 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 - включение левой границы

isRightIncluded - включение правой границы

Возвращает:

поток псевдослучайных 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 - количество значений для генерации

Возвращает:

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

Исключения:

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

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

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

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

Параметры:

streamSize - количество значений для генерации

randomNumberOrigin - минимальное значение (включительно)

randomNumberBound - максимальное значение (исключающее)

Возвращает:

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

Исключения:

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 значение, псевдослучайно выбранное из экспоненциального распределения