قيّد قيمةً بين حدَّين باستدعاء واحد واضح.
مقارنة الكود
✕ 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) لا لبس فيه.
أقل عرضة للأخطاء
لا مزيد من عكس ترتيب min/max عن طريق الخطأ.
جميع الأنواع الرقمية
تعمل مع int و long و float و double.
الأسلوب القديم
min/max متداخلة
الأسلوب الحديث
Math.clamp()
منذ JDK
21
الصعوبة
مبتدئ
دعم JDK
Math.clamp()
متاح
متاح على نطاق واسع منذ JDK 21 LTS (سبتمبر 2023)
كيف يعمل
تُقيّد Math.clamp(value, min, max) قيمةً بالمجال [min, max]. أوضح من min/max المتداخلة ومتاحة لأنواع int و long و float و double.
توثيق ذو صلة