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

المراجعة الحالية بتاريخ 11:23، 3 ديسمبر 2018

يقرِّب التابع 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: يحول العدد الجذري الذي استدعي معه إلى عدد عشري.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>round‎</code> الخاص بالصنف <code>Rational</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Rational.round‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Rational]]
-يعيد التابع <code>round</code> العدد الذي استُدعي معه <code>rat</code> مُقرّبًا إلى أقرب قيمة مع دقة <code>ndigits</code> منزلًا عشريًا (القيمة الافتراضية هي 0).
+يقرِّب التابع <code>round</code> العدد الجذري الذي استُدعي معه إلى أقرب قيمة مع دقة محدَّدة للمنازل العشرية.
-عندما تكون الدقة سالبة، القيمة التي تُعاد ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل.
-يُعيد التابع <code>round</code> عددًا جذريًا عندما يكون الوسيط <code>ndigits</code> موجبًا، وإلا فسيُعيد عددًا صحيحًا.
-يمكن تمرير وسيط مُسمى (keyword argument) اختياري <code>half</code> بشكل مماثل للتابع <code>[[Ruby/Float/round|Float#round]]</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">round([ndigits] [, half: mode])  →  integer or rational‎</syntaxhighlight>
 ==المعاملات==
 ===<code>ndigits‎</code>===
-يحدد عدد المنازل العشرية
+يحدد عدد المنازل العشرية. القيمة الافتراضية هي: 0. عندما تكون الدقة موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل.
-===<code>half: mode‎</code>===
-==القيمة المُعادة==
+=== <code>half</code> ===
+معامل مُسمى اختياري <code>half</code> مماثل تمامًا للموجود في التابع <code>[[Ruby/Float/round|Float.round]]</code>. يعمل على ضبط وضع التقريب للأعداد التي تقع في المنتصف بين قيمتين مقرَّبتين ممكنتين وفقًا للوضع <code>mode</code> المُحدَّد.
+==القيمة المعادة==
+يعاد العدد الجذري المعطى مُقرّبًا إلى أقرب قيمة مع دقة <code>ndigits</code> منزلًا عشريًا. عندما تكون الدقة <code>ndigits</code> موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل.
 ==أمثلة==
@@ سطر 27: / سطر 25: @@
 Rational('-123.456').round(+1).to_f  #=> -123.5
 Rational('-123.456').round(-1)       #=> -120‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/Rational/rationalize|rationalize]]</code>: يُعيد  تقريبًا مبسطًا لقيمة العدد في حال إعطاء الوسيط الاختياري <code>eps</code> (النتيجة ستحقق المتراجحة)، وبخلاف ذلك سيعيد العدد نفسه.
+* التابع [[Ruby/Rational/ceil|<code>ceil</code>]]: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الجذري الذي استُدعي معه وفق دقة محدَّدة للمنازل العشرية بعد الفاصلة.
-* التابع <code>[[Ruby/Rational/to_f|to_f]]</code>: يُعيد  القيمة على هيئة <code>[[Ruby/Float|Float]]</code>.
+* التابع [[Ruby/Rational/floor|<code>floor</code>]]: يعيد أكبر عدد من الأعداد الأصغر من أو تساوي العدد الجذري الذي استُدعي معه مع دقة محدَّدة للمنازل العشرية.
+* التابع <code>[[Ruby/Rational/to_f|to_f]]</code>: يحول العدد الجذري الذي استدعي معه إلى عدد عشري.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Rational.html#method-i-round قسم  التابع round‎ في الصنف Rational‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Rational.html#method-i-round قسم التابع round في الصنف Rational في توثيق روبي الرسمي.]