nextInt

open override fun nextInt(): Int

Gets the next random Int from the random number generator.

Generates an Int random value uniformly distributed between Int.MIN_VALUE and Int.MAX_VALUE (inclusive).

Samples

import samples.*
import kotlin.math.sin
import kotlin.random.Random
import kotlin.test.assertTrue
fun main() { 
   //sampleStart 
   val randomInts = List(5) { Random.nextInt() }
println(randomInts)
val sortedRandomInts = randomInts.sorted()
println(sortedRandomInts) 
   //sampleEnd
}

open override fun nextInt(until: Int): Int

Gets the next random non-negative Int from the random number generator less than the specified until bound.

Generates an Int random value uniformly distributed between 0 (inclusive) and the specified until bound (exclusive).

Samples

import samples.*
import kotlin.math.sin
import kotlin.random.Random
import kotlin.test.assertTrue
fun main() { 
   //sampleStart 
   val menu = listOf("Omelette", "Porridge", "Cereal", "Chicken", "Pizza", "Pasta")
val forBreakfast = Random.nextInt(until = 3).let { menu[it] }
val forLunch = Random.nextInt(from = 3, until = 6).let { menu[it] }
// new meals every time
println("Today I want $forBreakfast for breakfast, and $forLunch for lunch.") 
   //sampleEnd
}

Parameters

until

must be positive.

Throws

if until is negative or zero.


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

Gets the next random Int from the random number generator in the specified range.

Generates an Int random value uniformly distributed between the specified from (inclusive) and until (exclusive) bounds.

Samples

import samples.*
import kotlin.math.sin
import kotlin.random.Random
import kotlin.test.assertTrue
fun main() { 
   //sampleStart 
   val menu = listOf("Omelette", "Porridge", "Cereal", "Chicken", "Pizza", "Pasta")
val forBreakfast = Random.nextInt(until = 3).let { menu[it] }
val forLunch = Random.nextInt(from = 3, until = 6).let { menu[it] }
// new meals every time
println("Today I want $forBreakfast for breakfast, and $forLunch for lunch.") 
   //sampleEnd
}

Throws

if from is greater than or equal to until.