التابع Integer.round‎ في روبي

من موسوعة حسوب
< Ruby‏ | Integer

يقرِّب التابع round‎ العدد الذي استُدعي معه إلى أقرب قيمة مع دقة (precision) تساوي العدد الممرر إليه.

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

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

المعاملات

ndigits‎

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

half

وسيط اختياري يعمل بشكل مماثل لعمله في الوسيط Float.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: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه.

مصادر