kotlin-stdlib/kotlin.random/Random/nextInt

nextInt

open 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
}
open 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

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
}
open 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

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
}