Функция coerceAtLeast

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

Синтаксис

kotlinfun Int.coerceAtLeast(minimumValue: Int): Int
kotlinfun Long.coerceAtLeast(minimumValue: Long): Long
kotlinfun Double.coerceAtLeast(minimumValue: Double): Double
kotlinfun Float.coerceAtLeast(minimumValue: Float): Float

Пример

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

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

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

kotlinInt 10

Пример

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

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

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

kotlinInt 15

Пример

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

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

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

kotlinDouble 5.0

Пример

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

kotlinvar temperature = 15

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

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

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

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

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