Random

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

abstract class Random

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

Объект-компаньон Random.Default является экземпляром Random по умолчанию.

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

Примеры

import kotlin.math.sin
import kotlin.random.Random
import kotlin.test.assertTrue

fun main() { 
   //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
}

Наследники

Default

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

Random

Требования к платформе и версии: Common

constructor()

Типы

Default

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

object Default : Random, Serializable

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

Функции

asJavaRandom

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

fun Random.asJavaRandom(): Random

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

nextBits

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

abstract fun nextBits(bitCount: Int): Int

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

nextBoolean

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

open fun nextBoolean(): Boolean

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

nextBytes

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


@IgnorableReturnValue
open fun nextBytes(array: ByteArray): ByteArray

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

open fun nextBytes(size: Int): ByteArray

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


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

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

nextDouble

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

open fun nextDouble(): Double

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

open fun nextDouble(until: Double): Double

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

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

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

nextFloat

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

open fun nextFloat(): Float

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

nextInt

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

open fun nextInt(): Int

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

open fun nextInt(until: Int): Int

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

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

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

nextInt

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

fun Random.nextInt(range: IntRange): Int

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

nextLong

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

open fun nextLong(): Long

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

open fun nextLong(until: Long): Long

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

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

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

nextLong

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

fun Random.nextLong(range: LongRange): Long

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

nextUBytes

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


@ExperimentalUnsignedTypes
fun Random.nextUBytes(size: Int): UByteArray

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



@ExperimentalUnsignedTypes


@IgnorableReturnValue

fun Random.nextUBytes(array: UByteArray): UByteArray

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



@ExperimentalUnsignedTypes


@IgnorableReturnValue

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

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

nextUInt

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

fun Random.nextUInt(): UInt

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

fun Random.nextUInt(until: UInt): UInt

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

fun Random.nextUInt(range: UIntRange): UInt

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

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

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

nextULong

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

fun Random.nextULong(): ULong

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

fun Random.nextULong(until: ULong): ULong

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

fun Random.nextULong(range: ULongRange): ULong

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

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

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

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