Случайный

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

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

abstract class Random

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

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

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

import kotlin.math.sin
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, Serializable

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

Требования к платформе и версии: 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

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

fun Random.nextUBytes(array: UByteArray): UByteArray

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

fun Random.nextUBytes(size: Int): UByteArray

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

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

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

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.5), JS (1.5), Native (1.5)

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–2022 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