Kotlin - 边界控制 coerceIn、coerceAtLeast、coerceAtMost

Jomurphys2025-06-21 10:11

一、概念

当需要对数值进行范围限制时，通常会用 if() else if() else，这样会写很多判断，使用 coerceXXX() 函数来简化，适用于实现了 Comparable 接口的对象。

|-----------------|------------------------------------------------------------------------------------------------------------|
| coerceIn() | public fun <T : Comparable<T>> T.coerceIn(minimumValue: T?, maximumValue: T?): T 限制数值在给定范围之内，超出则返回边界值。 |
| coerceAtLeast() | public fun <T : Comparable<T>> T.coerceAtLeast(minimumValue: T): T 确保值不小于指定最小值，小于则返回最小值。 |
| coerceAtMost() | public fun <T : Comparable<T>> T.coerceAtMost(maximumValue: T): T 确保值不大于指定最大值，大于则返回最大值。 |

Kotlin 复制代码

fun demo(age: Int) {
    val safeAge = age.corceIn(0, 130)
}

Kotlin 复制代码

data class Person(val age: Int) : Comparable<Person> {
    override fun compareTo(other: Person): Int {
        return this.age - other.age
    }
}

fun main() {
    val a = Person(1)
    val b = Person(3)
    val c = Person(5)
    val result = c.coerceIn(a, b)
    print(result)   //打印：Person(age=3)
}