Функция coerceAtLeast

Функция coerceAtLeast ограничивает значение снизу, возвращая максимальное из переданного значения и указанного минимального порога. Если текущее значение больше или равно минимальному порогу, возвращается текущее значение. Если текущее значение меньше минимального порога, возвращается минимальный порог.

Синтаксис

fun Int.coerceAtLeast(minimumValue: Int): Int

fun Long.coerceAtLeast(minimumValue: Long): Long

fun Double.coerceAtLeast(minimumValue: Double): Double

fun Float.coerceAtLeast(minimumValue: Float): Float

Пример

Ограничим число 5 снизу значением 10:

val num = 5
val res = num.coerceAtLeast(10)
println(res)

Результат выполнения кода:

Int 10

Пример

Ограничим число 15 снизу значением 10:

val num = 15
val res = num.coerceAtLeast(10)
println(res)

Результат выполнения кода:

Int 15

Пример

Ограничим число с плавающей точкой 3.14 снизу значением 5.0:

val num = 3.14
val res = num.coerceAtLeast(5.0)
println(res)

Результат выполнения кода:

Double 5.0

Пример

Использование функции для проверки минимального значения в цикле:

var temperature = 15

for (i in 1..5) {
	temperature -= 3
	val safeTemp = temperature.coerceAtLeast(10)
	println("Current: $temperature, Safe: $safeTemp")
}

Результат выполнения кода:

Current: 12, Safe: 12
Current: 9, Safe: 10
Current: 6, Safe: 10
Current: 3, Safe: 10
Current: 0, Safe: 10

Смотрите также

функцию coerceAtMost,
которая ограничивает значение сверху
функцию coerceIn,
которая ограничивает значение с двух сторон
функцию rangeTo,
которая создает диапазон значений
функцию rangeUntil,
которая создает диапазон не включая конечное значение