Arduino/math/max

تعيد الدالة max()‎ أكبر قيمة من القيم الممرَّرة إليها.

البنية العامة

max(x, y)

المعاملات

x

العدد الأول المراد معرفة إن كان أكبر من العدد y وإعادته.

y

العدد الثاني المراد معرفة إن كان أكبر من العدد x وإعادته.

القيم المعادة

يعاد العدد الأكبر من بين العددين x و y.

أمثلة

استعمال الدالة max()‎ للتأكد من أنَّ القيمة المقاسة من الحساس لن تقل عن قيمة معيَّنة:

sensVal = max(sensVal, 20); // نفسه sensVal إلى المتغير sensVal اسناد القيمة الأكبر بين 20 و
                            // (تستعمل هذه الدالة للتأكد من عدم انخفاض قيمة مقاسة عن حد معين)

ملاحظات وتحذيرات

تستعمل الدالة max()‎ عادةً -بشكل خارج عن المألوف- لتقييد الحد الأدنى لقيمة متغير بينما تستعمل الدالة min()‎ لتقييد الحد الأعلى لقيمة المتغير.

بسبب الطريقة التي تُنفَّذ فيها الدالة max()‎، تجنب استعمال أية دالة أخرى داخل قوسي هذه الدالة لأنَّ ذلك قد يؤدي إلى نتائج غير صحيحة.

max(a--, 0);   // تجنب فعل هذا، إذ يعطي نتائج خطأ

max(a, 0);     // استعمل الدالة بهذا الشكل عوضًا عن ذلك
a--;           // أبقِ جميع العمليات الرياضية الأخرى خارج الدالة

انظر أيضًا

• الدالة abs()‎: تحسب القيمة المطلقة للعدد المُمرَّر إليها.
• الدالة constrain()‎: تقيِّد عددًا ضمن مجالٍ محدَّدٍ.
• الدالة min()‎: تعيد أصغر قيمة من القيم الممرَّرة إليها.
• الدالة map()‎: تعيد تموضع عدد من المجال الذي هو فيه إلى مجال آخر.

مصادر

• صفحة الدالة max()‎ في توثيق أردوينو الرسمي.