عرض مصدر Ruby/Integer/round

<noinclude>{{DISPLAYTITLE: التابع <code>Integer.round‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Integer]]
يقرِّب التابع <code>round‎</code> العدد الذي استُدعي معه إلى أقرب قيمة مع دقة (precision) تساوي العدد الممرر إليه. 
==البنية العامة==
<syntaxhighlight lang="ruby">round([ndigits] [, half: mode])  →  integer or float‎</syntaxhighlight>
==المعاملات==

===<code>ndigits‎</code>===

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

=== <code>half</code> ===
وسيط اختياري يعمل بشكل مماثل لعمله في الوسيط [[Ruby/Float/round|Float.round]].
==القيمة المعادة==
يعاد العدد الذي استُدعي معه مُقرّبًا  إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل. في حال كانت قيمة <code>ndigits‎</code> منعدمة أو موجبة، فسيعيد التابع <code>round‎</code> العدد الذي استُدعي معه. 
==أمثلة==
أمثلة على استخدام التابع <code>round‎</code>:
<syntaxhighlight lang="ruby">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</syntaxhighlight>
==انظر أيضا==
* التابع <code>[[Ruby/Integer/ceil|ceil]]</code>: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه. 

==مصادر==
*[http://ruby-doc.org/core-2.5.1/Integer.html#method-i-round قسم التابع round‎ في الصنف Integer‎ في توثيق روبي الرسمي.]