التابع Rational.round في روبي
يقرِّب التابع round العدد الجذري الذي استُدعي معه إلى أقرب قيمة مع دقة محدَّدة للمنازل العشرية.
البنية العامة
round([ndigits] [, half: mode]) → integer or rational
المعاملات
ndigits
يحدد عدد المنازل العشرية. القيمة الافتراضية هي: 0. عندما تكون الدقة موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع ndigits.abs صفرًا زائدًا على الأقل.
half
معامل مُسمى اختياري half مماثل تمامًا للموجود في التابع Float.round. يعمل على ضبط وضع التقريب للأعداد التي تقع في المنتصف بين قيمتين مقرَّبتين ممكنتين وفقًا للوضع mode المُحدَّد.
القيمة المعادة
يعاد العدد الجذري المعطى مُقرّبًا إلى أقرب قيمة مع دقة ndigits منزلًا عشريًا. عندما تكون الدقة ndigits موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع ndigits.abs صفرًا زائدًا على الأقل.
أمثلة
مثال على استخدام التابع round:
Rational(3).round #=> 3
Rational(2, 3).round #=> 1
Rational(-3, 2).round #=> -2
# decimal - 1 2 3 . 4 5 6
# ^ ^ ^ ^ ^ ^
# precision -3 -2 -1 0 +1 +2
Rational('-123.456').round(+1).to_f #=> -123.5
Rational('-123.456').round(-1) #=> -120
انظر أيضًا
- التابع
ceil: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الجذري الذي استُدعي معه وفق دقة محدَّدة للمنازل العشرية بعد الفاصلة.
- التابع
floor: يعيد أكبر عدد من الأعداد الأصغر من أو تساوي العدد الجذري الذي استُدعي معه مع دقة محدَّدة للمنازل العشرية.
- التابع
to_f: يحول العدد الجذري الذي استدعي معه إلى عدد عشري.