Класс ThreadLocalRandom

public static ThreadLocalRandom current()

Возвращает:

объект ThreadLocalRandom текущего потока

public void setSeed(long seed)

Переопределяет:

setSeed в классе Random

Параметры:

seed — значение начального параметра

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

UnsupportedOperationException — всегда

protected int next(int bits)

Переопределяет:

next в классе Random

Параметры:

bits — случайные биты

Возвращает:

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

public int nextInt(int bound)

Определён в:

nextInt в интерфейсе RandomGenerator

Переопределяет:

nextInt в классе Random

Параметры:

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

Возвращает:

следующее псевдослучайное равномерно распределённое значение int от нуля (включительно) до bound (исключительно) из последовательности этого генератора случайных чисел

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

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

public int nextInt(int origin, int bound)

Параметры:

origin — наименьшее значение, которое может быть возвращено

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

Возвращает:

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

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

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

public long nextLong(long bound)

Параметры:

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

Возвращает:

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

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

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

public long nextLong(long origin, long bound)

Параметры:

origin — наименьшее значение, которое может быть возвращено

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

Возвращает:

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

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

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

public double nextGaussian()

Определён в:

nextGaussian в интерфейсе RandomGenerator

Переопределяет:

nextGaussian в классе Random

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

В этой реализации вызывается реализация по умолчанию метода RandomGenerator.nextGaussian(), поэтому используется быстрый модифицированный алгоритм зиггурат Макфарланда, а не полярный метод, описанный в суперклассе.

Возвращает:

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

public float nextFloat(float bound)

Параметры:

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

Возвращает:

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

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

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

Начиная с:

17

public float nextFloat(float origin, float bound)

Параметры:

origin — наименьшее значение, которое может быть возвращено

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

Возвращает:

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

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

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

Начиная с:

17

public double nextDouble(double bound)

Параметры:

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

Возвращает:

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

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

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

public double nextDouble(double origin, double bound)

Параметры:

origin — наименьшее значение, которое может быть возвращено

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

Возвращает:

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

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

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

public IntStream ints(long streamSize)

Определён в:

ints в интерфейсе RandomGenerator

Переопределяет:

ints в классе Random

Параметры:

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

Возвращает:

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

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

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

Начиная с:

1.8

public IntStream ints()

Определён в:

ints в интерфейсе RandomGenerator

Переопределяет:

ints в классе Random

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

Этот метод реализован так, чтобы быть эквивалентным ints(Long.MAX_VALUE).

Возвращает:

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

Начиная с:

1.8

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

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;
  }
}

Определён в:

ints в интерфейсе RandomGenerator

Переопределяет:

ints в классе Random

Параметры:

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

randomNumberOrigin — начало (включительно) каждого случайного значения

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

Возвращает:

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

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

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

Начиная с:

1.8

public IntStream ints(int randomNumberOrigin, int randomNumberBound)

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;
  }
}

Определён в:

ints в интерфейсе RandomGenerator

Переопределяет:

ints в классе Random

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

Этот метод реализован так, чтобы быть эквивалентным ints(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Параметры:

randomNumberOrigin — начало (включительно) каждого случайного значения

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

Возвращает:

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

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

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

Начиная с:

1.8

public LongStream longs(long streamSize)

Определён в:

longs в интерфейсе RandomGenerator

Переопределяет:

longs в классе Random

Параметры:

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

Возвращает:

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

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

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

Начиная с:

1.8

public LongStream longs()

Определён в:

longs в интерфейсе RandomGenerator

Переопределяет:

longs в классе Random

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

Этот метод реализован так, чтобы быть эквивалентным longs(Long.MAX_VALUE).

Возвращает:

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

Начиная с:

1.8

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

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;
}

Определён в:

longs в интерфейсе RandomGenerator

Переопределяет:

longs в классе Random

Параметры:

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

randomNumberOrigin — начало (включительно) каждого случайного значения

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

Возвращает:

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

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

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

Начиная с:

1.8

public LongStream longs(long randomNumberOrigin, long randomNumberBound)

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;
}

Определён в:

longs в интерфейсе RandomGenerator

Переопределяет:

longs в классе Random

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

Этот метод реализован так, чтобы быть эквивалентным longs(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Параметры:

randomNumberOrigin — начало (включительно) каждого случайного значения

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

Возвращает:

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

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

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

Начиная с:

1.8

public DoubleStream doubles(long streamSize)

Определён в:

doubles в интерфейсе RandomGenerator

Переопределяет:

doubles в классе Random

Параметры:

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

Возвращает:

поток значений double

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

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

Начиная с:

1.8

public DoubleStream doubles()

Определён в:

doubles в интерфейсе RandomGenerator

Переопределяет:

doubles в классе Random

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

Этот метод реализован так, чтобы быть эквивалентным doubles(Long.MAX_VALUE).

Возвращает:

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

Начиная с:

1.8

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

Определён в:

doubles в интерфейсе RandomGenerator

Переопределяет:

doubles в классе Random

Параметры:

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

randomNumberOrigin — начало (включительно) каждого случайного значения

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

Возвращает:

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

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

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

Начиная с:

1.8

public DoubleStream doubles(double randomNumberOrigin, double randomNumberBound)

Определён в:

doubles в интерфейсе RandomGenerator

Переопределяет:

doubles в классе Random

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

Этот метод реализован так, чтобы быть эквивалентным doubles(Long.MAX_VALUE, randomNumberOrigin, randomNumberBound).

Параметры:

randomNumberOrigin — начало (включительно) каждого случайного значения

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

Возвращает:

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

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

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

Начиная с:

1.8