Случайное

kotlin-stdlib / kotlin.random / Случайное

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

abstract class Random

Абстрактный класс, реализуемый алгоритмами генерации случайных чисел.

Объект-компаньон Случайное.По умолчанию — это экземпляр Случайного по умолчанию.

Чтобы получить экземпляр генератора случайных чисел с заданным начальным значением, используйте функцию Случайное.

import kotlin.random.Random
import kotlin.test.assertTrue

fun main(args: Array<String>) {
//sampleStart
val randomValues = List(10) { Random.nextInt(0, 100) }
// prints new sequence every time
println(randomValues)

val nextValues = List(10) { Random.nextInt(0, 100) }
println(nextValues)
println("randomValues != nextValues is ${randomValues != nextValues}") // true
//sampleEnd
}

Типы

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

По умолчанию

Генератор случайных чисел по умолчанию.

companion object Default : Random

Конструкторы

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

<init>

Абстрактный класс, реализуемый алгоритмами генерации случайных чисел.

Random()

Функции

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextBits

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

abstract fun nextBits(bitCount: Int): Int

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextBoolean

Возвращает следующее случайное значение Boolean.

open fun nextBoolean(): Boolean

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextBytes

Заполняет поддиапазон указанного массива байтов array начиная с fromIndex включительно и заканчивая toIndex исключая случайными байтами.

open fun nextBytes(
    array: ByteArray, 
    fromIndex: Int = 0, 
    toIndex: Int = array.size
): ByteArray

Заполняет указанный массив байтов array случайными байтами и возвращает его.

open fun nextBytes(array: ByteArray): ByteArray

Создает массив байтов указанного размера, заполненный случайными байтами.

open fun nextBytes(size: Int): ByteArray

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextDouble

Возвращает следующее случайное значение Double, равномерно распределенное между 0 (включительно) и 1 (исключительно).

open fun nextDouble(): Double

Возвращает следующее случайное неотрицательное Double из генератора случайных чисел, меньшее заданного until предела.

open fun nextDouble(until: Double): Double

Возвращает следующее случайное Double из генератора случайных чисел в заданном диапазоне.

open fun nextDouble(from: Double, until: Double): Double

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextFloat

Возвращает следующее случайное значение Float, равномерно распределенное между 0 (включительно) и 1 (исключительно).

open fun nextFloat(): Float

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextInt

Возвращает следующее случайное Int из генератора случайных чисел.

open fun nextInt(): Int

Возвращает следующее случайное неотрицательное Int из генератора случайных чисел, меньшее заданного until предела.

open fun nextInt(until: Int): Int

Возвращает следующее случайное Int из генератора случайных чисел в заданном диапазоне.

open fun nextInt(from: Int, until: Int): Int

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextLong

Возвращает следующее случайное Long из генератора случайных чисел.

open fun nextLong(): Long

Возвращает следующее случайное неотрицательное Long из генератора случайных чисел, меньшее заданного until предела.

open fun nextLong(until: Long): Long

Возвращает следующее случайное Long из генератора случайных чисел в заданном диапазоне.

open fun nextLong(from: Long, until: Long): Long

Функции объекта-компаньона

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextBits

Получение следующего случайного числа битов bitCount.

fun nextBits(bitCount: Int): Int

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextBoolean

Получение следующего случайного значения типа Boolean.

fun nextBoolean(): Boolean

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextBytes

Заполняет указанный массив байт array случайными байтами и возвращает его.

fun nextBytes(array: ByteArray): ByteArray

Создает массив байтов заданного размера size, заполненный случайными байтами.

fun nextBytes(size: Int): ByteArray

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

fun nextBytes(
    array: ByteArray, 
    fromIndex: Int, 
    toIndex: Int
): ByteArray

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextDouble

Получение следующего случайного значения типа Double, равномерно распределенного между 0 (включительно) и 1 (исключительно).

fun nextDouble(): Double

Получение следующего случайного неотрицательного Double генератора случайных чисел, меньшего заданного значения until.

fun nextDouble(until: Double): Double

Получение следующего случайного Double генератора случайных чисел в указанном диапазоне.

fun nextDouble(from: Double, until: Double): Double

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextFloat

Получение следующего случайного значения типа Float, равномерно распределенного между 0 (включительно) и 1 (исключительно).

fun nextFloat(): Float

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextInt

Получение следующего случайного Int генератора случайных чисел.

fun nextInt(): Int

Получение следующего случайного неотрицательного Int генератора случайных чисел, меньшего заданного значения until.

fun nextInt(until: Int): Int

Получение следующего случайного Int генератора случайных чисел в указанном диапазоне.

fun nextInt(from: Int, until: Int): Int

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

nextLong

Получение следующего случайного Long генератора случайных чисел.

fun nextLong(): Long

Получение следующего случайного неотрицательного Long генератора случайных чисел, меньшего заданного значения until.

fun nextLong(until: Long): Long

Получение следующего случайного Long генератора случайных чисел в указанном диапазоне.

fun nextLong(from: Long, until: Long): Long

Функции расширения

Требования к платформе и версии: JVM (1.3)

asJavaRandom

Создает экземпляр java.util.Random, использующий указанный генератор случайных чисел Kotlin в качестве источника случайности.

fun Random.asJavaRandom(): Random

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

nextInt

Возвращает следующее случайное Int из генератора случайных чисел в указанном диапазоне.

fun Random.nextInt(range: IntRange): Int

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

nextLong

Возвращает следующее случайное Long из генератора случайных чисел в указанном диапазоне.

fun Random.nextLong(range: LongRange): Long

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

nextUBytes

Заполняет указанный массив беззнаковых байтов массив случайными байтами и возвращает его.

fun Random.nextUBytes(array: UByteArray): UByteArray

Создаёт массив беззнаковых байтов заданного размера, заполненный случайными байтами.

fun Random.nextUBytes(size: Int): UByteArray

Заполняет поддиапазон указанного UByte массива, начиная с индекса начала включительно и заканчивая индексом конца исключая, случайными беззнаковыми байтами.

fun Random.nextUBytes(
    array: UByteArray, 
    fromIndex: Int = 0, 
    toIndex: Int = array.size
): UByteArray

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

nextUInt

Возвращает следующее случайное UInt из генератора случайных чисел.

fun Random.nextUInt(): UInt

Возвращает следующее случайное UInt из генератора случайных чисел, меньшее указанного предела.

fun Random.nextUInt(until: UInt): UInt

Возвращает следующее случайное UInt из генератора случайных чисел в указанном диапазоне.

fun Random.nextUInt(from: UInt, until: UInt): UInt

Возвращает следующее случайное UInt из генератора случайных чисел в указанном диапазоне.

fun Random.nextUInt(range: UIntRange): UInt

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

nextULong

Возвращает следующее случайное ULong из генератора случайных чисел.

fun Random.nextULong(): ULong

Возвращает следующее случайное ULong из генератора случайных чисел, меньшее указанного предела.

fun Random.nextULong(until: ULong): ULong

Возвращает следующее случайное ULong из генератора случайных чисел в указанном диапазоне.

fun Random.nextULong(from: ULong, until: ULong): ULong

Возвращает следующее случайное ULong из генератора случайных чисел в указанном диапазоне.

fun Random.nextULong(range: ULongRange): ULong

© 2010–2020 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.random/-random/index.html