Random

A Guest pseudorandom source. Seeded generators and Default are reproducible on Compukters; their sequences are independent of Kotlin/JVM implementations. Not a cryptographic source. Each call executes ordinary metered Guest instructions.

Inheritors

Default

Constructors

Random

constructor()

Types

Default

object Default : Random

The shared, program-local sequence starts from seed 0L; aliases and tasks share its state.

Functions

nextBits

abstract fun nextBits(bitCount: Int): Int

Returns random low bits with upper bits zero; bitCount must be in 0..32.

nextBoolean

open fun nextBoolean(): Boolean

nextBytes

open fun nextBytes(array: ByteArray): ByteArray

open fun nextBytes(size: Int): ByteArray

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

Fills exactly [fromIndex, toIndex); invalid ranges leave both array and generator unchanged.

nextDouble

open fun nextDouble(): Double

Uniform 53-bit fraction in [0, 1).

open fun nextDouble(until: Double): Double

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

Finite bounds with an exclusive upper endpoint, including adjacent representable values.

nextFloat

open fun nextFloat(): Float

Uniform 24-bit fraction in [0, 1).

nextInt

open fun nextInt(): Int

open fun nextInt(until: Int): Int

Uniform value in [0, until).

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

Uniform value in [from, until); invalid bounds do not consume random bits.

nextInt

fun Random.nextInt(range: IntRange): Int

Uniform value in the inclusive range, including the full Int domain.

nextLong

open fun nextLong(): Long

open fun nextLong(until: Long): Long

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

nextLong

fun Random.nextLong(range: LongRange): Long

Uniform value in the inclusive range, including the full Long domain.

nextUBytes

fun Random.nextUBytes(size: Int): UByteArray

fun Random.nextUBytes(array: UByteArray): UByteArray

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

Fills exactly [fromIndex, toIndex); invalid ranges do not consume state or modify the array.

nextUInt

fun Random.nextUInt(): UInt

Unsigned full-width bits from this source.

fun Random.nextUInt(until: UInt): UInt

fun Random.nextUInt(range: UIntRange): UInt

Uniform value in the inclusive range, including the full UInt domain.

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

Uniform value in [from, until), using rejection before modulo reduction.

nextULong

fun Random.nextULong(): ULong

Unsigned full-width bits from this source.

fun Random.nextULong(until: ULong): ULong

fun Random.nextULong(range: ULongRange): ULong

Uniform value in the inclusive range, including the full ULong domain.

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

Uniform value in [from, until), using rejection before modulo reduction.