kotlin-stdlib/kotlin.random/Random/Default/nextInt

nextInt

open override fun nextInt(): Int(source)

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).

Since Kotlin

1.3

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
}
xxxxxxxxxx
 
val randomInts = List(5) { Random.nextInt() }
println(randomInts)
val sortedRandomInts = randomInts.sorted()
println(sortedRandomInts) 
Open in Playground →
Target: JVMRunning on v.2.1.20

open override fun nextInt(until: Int): Int(source)

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).

Since Kotlin

1.3

Parameters

until

must be positive.

Throws

IllegalArgumentException

if until is negative or zero.

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
}
xxxxxxxxxx
 
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.") 
Open in Playground →
Target: JVMRunning on v.2.1.20

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

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.

Since Kotlin

1.3

Throws

IllegalArgumentException

if from is greater than or equal to until.

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
}
xxxxxxxxxx
 
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.") 
Open in Playground →
Target: JVMRunning on v.2.1.20

Thanks for your feedback!

Was this page helpful?