الفرق بين المراجعتين لصفحة: «Ruby/Integer/round»

المراجعة الحالية بتاريخ 06:51، 15 نوفمبر 2018

يقرِّب التابع 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: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>round‎</code> الخاص بالصنف <code>Integer</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Integer.round‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Integer]]
-يعيد التابع <code>round‎</code> أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه وبدقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
+يقرِّب التابع <code>round‎</code> العدد الذي استُدعي معه إلى أقرب قيمة مع دقة (precision) تساوي العدد الممرر إليه.
-إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
-في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>round‎</code> العدد الذي استُدعي معه.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">round([ndigits] [, half: mode])  →  integer or float‎</syntaxhighlight>
@@ سطر 18: / سطر 10: @@
 ===<code>ndigits‎</code>===
-عدد يحدد الدقة.
+عدد يحدد الدقة. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل. أمَّا في حال كانت قيمة <code>ndigits‎</code> منعدمة أو موجبة، فسيعيد التابع <code>round‎</code> العدد الذي استُدعي معه. القيمة الافتراضية لهذا المعامل هي: 0.
-==القيمة المُعادة==
-يعيد التابع <code>round‎</code> أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه وبدقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
-إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
+=== <code>half</code> ===
+وسيط اختياري يعمل بشكل مماثل لعمله في الوسيط [[Ruby/Float/round|Float.round]].
+==القيمة المعادة==
+يعاد العدد الذي استُدعي معه مُقرّبًا  إلى أقرب قيمة، مع دقة (precision) تساوي <code>ndigits</code> رقم عشري. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل. في حال كانت قيمة <code>ndigits‎</code> منعدمة أو موجبة، فسيعيد التابع <code>round‎</code> العدد الذي استُدعي معه.
-في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>round‎</code> العدد الذي استُدعي معه.
 ==أمثلة==
-مثال على استخدام التابع <code>round‎</code>:
+أمثلة على استخدام التابع <code>round‎</code>:
 <syntaxhighlight lang="ruby">1.round           #=> 1
 .round(2)        #=> 1
 .round(-1)      #=> 20
 (-15).round(-1)   #=> -20
-‎</syntaxhighlight>
+‎
+.round(-1, half: :up)      #=> 30
+.round(-1, half: :down)    #=> 20
+.round(-1, half: :even)    #=> 20
+.round(-1, half: :up)      #=> 40
+.round(-1, half: :down)    #=> 30
+.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>: يعيد التابع <code>ceil‎</code> أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه وبدقة (precision) تساوي <code>ndigits</code> رقم عشري (القيمة الابتدائية هي <code>0</code>) .
+* التابع <code>[[Ruby/Integer/ceil|ceil]]</code>: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه.
-إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل.
-في حال كانت قيمة  <code>ndigits‎</code> منعدمة أو سالبة، فسيعيد التابع <code>ceil‎</code> العدد الذي استُدعي معه.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Integer.html#method-i-round قسم  التابع round‎ في الصنف Integer‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Integer.html#method-i-round قسم التابع round‎ في الصنف Integer‎ في توثيق روبي الرسمي.]