Date/Time 入门

Math.clamp()

用单个清晰的调用将值限制在边界之间。

代码对比

✕ Java 8

// Clamp value between min and max
int clamped =
    Math.min(Math.max(value, 0), 100);
// or: min and max order confusion

✓ Java 21+

int clamped =
    Math.clamp(value, 0, 100);
// value constrained to [0, 100]

发现此代码有问题？告诉我们。

为什么现代方式更好

📖

clamp(value, min, max) 无歧义。

📏

替代嵌套的 Math.min(max, Math.max(min, value))。

🔒

当 min > max 时抛出，捕获错误范围。

旧方式

嵌套 min/max

现代方式

Math.clamp()

自 JDK

难度

入门

JDK 支持

Math.clamp()

可用

自 JDK 21 LTS 起广泛可用（2023 年 9 月）

工作原理

Math.clamp(value, min, max) 将值约束在范围 [min, max] 内。如果 min > max，则抛出 IllegalArgumentException。它适用于 int、long、float 和 double。