Ruby/Integer/round

يعيد التابع round‎ العدد الذي استُدعي معه مُقرّبًا (rounded) إلى أقرب قيمة، مع دقة (precision) تساوي ndigits رقم عشري (القيمة الابتدائية هي 0) .

إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع ndigits.abs صفر إضافي على الأقل.

في حال كانت قيمة ndigits‎ منعدمة أو سالبة، فسيعيد التابع round‎ العدد الذي استُدعي معه.

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

round([ndigits] [, half: mode])  →  integer or float‎

المعاملات

ndigits‎

عدد يحدد الدقة.

half

وسيط اختياري يعمل بشكل مماثل لعمله في الوسيط Float#round.

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

يعيد التابع round‎ العدد الذي استُدعي معه مُقرّبًا إلى أقرب قيمة، مع دقة (precision) تساوي ndigits رقم عشري . إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع ndigits.abs صفر إضافي على الأقل. في حال كانت قيمة ndigits‎ منعدمة أو سالبة، فسيعيد التابع round‎ العدد الذي استُدعي معه.

أمثلة

مثال على استخدام التابع round‎:

1.round           #=> 1
1.round(2)        #=> 1
15.round(-1)      #=> 20
(-15).round(-1)   #=> -20
‎
25.round(-1, half: :up)      #=> 30
25.round(-1, half: :down)    #=> 20
25.round(-1, half: :even)    #=> 20
35.round(-1, half: :up)      #=> 40
35.round(-1, half: :down)    #=> 30
35.round(-1, half: :even)    #=> 40
(-25).round(-1, half: :up)   #=> -30
(-25).round(-1, half: :down) #=> -20
(-25).round(-1, half: :even) #=> -20

انظر أيضا

• التابع ceil: يعيد التابع ceil‎ أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه.

مصادر

• قسم التابع round‎ في الصنف Integer‎ في توثيق روبي الرسمي.