coerceAtMost所在位置是kotlin.ranges.coerceAtMost，其相關用法介紹如下。

用法一

fun <T : Comparable<T>> T.coerceAtMost(maximumValue: T): T

確保此值不大於指定的 maximumValue 。

例子：

import java.time.DayOfWeek
import kotlin.test.assertFailsWith

fun main(args: Array<String>) {
//sampleStart
println(DayOfWeek.FRIDAY.coerceAtMost(DayOfWeek.SATURDAY)) // FRIDAY
println(DayOfWeek.FRIDAY.coerceAtMost(DayOfWeek.WEDNESDAY)) // WEDNESDAY
//sampleEnd
}

輸出：

FRIDAY
WEDNESDAY

如果它小於或等於maximumValue，則返回此值，否則返回maximumValue。

用法二

fun Byte.coerceAtMost(maximumValue: Byte): Byte
fun Short.coerceAtMost(maximumValue: Short): Short
fun Int.coerceAtMost(maximumValue: Int): Int
fun Long.coerceAtMost(maximumValue: Long): Long
fun Float.coerceAtMost(maximumValue: Float): Float
fun Double.coerceAtMost(maximumValue: Double): Double

確保此值不大於指定的 maximumValue 。

例子：

import java.time.DayOfWeek
import kotlin.test.assertFailsWith

fun main(args: Array<String>) {
//sampleStart
println(10.coerceAtMost(5)) // 5
println(10.coerceAtMost(20)) // 10
//sampleEnd
}

輸出：

5
10

如果它小於或等於maximumValue，則返回此值，否則返回maximumValue。

用法三

fun UInt.coerceAtMost(maximumValue: UInt): UInt
fun ULong.coerceAtMost(maximumValue: ULong): ULong
fun UByte.coerceAtMost(maximumValue: UByte): UByte
fun UShort.coerceAtMost(maximumValue: UShort): UShort

確保此值不大於指定的 maximumValue 。

例子：

import java.time.DayOfWeek
import kotlin.test.assertFailsWith

fun main(args: Array<String>) {
//sampleStart
println(10u.coerceAtMost(5u)) // 5
println(10u.coerceAtMost(20u)) // 10
//sampleEnd
}

輸出：

5
10

如果它小於或等於maximumValue，則返回此值，否則返回maximumValue。