الفرق بين المراجعتين لصفحة: «Ruby/Rational/round»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>round</code> الخاص بالصنف <code>Rational</code> في روبي}}</noinclude> تصنيف: Ruby تصن...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Rational]] | [[تصنيف: Ruby Rational]] | ||
يعيد التابع <code>round</code> العدد الذي استُدعي معه | يعيد التابع <code>round</code> العدد الذي استُدعي معه مُقرّبًا إلى أقرب قيمة مع دقة <code>ndigits</code> منزلًا عشريًا (القيمة الافتراضية هي 0). | ||
عندما تكون الدقة سالبة، القيمة التي تُعاد ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل. | عندما تكون الدقة سالبة، القيمة التي تُعاد ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفرًا زائدًا على الأقل. | ||
يُعيد التابع <code>round</code> عددًا جذريًا عندما يكون الوسيط <code>ndigits</code> موجبًا، وإلا فسيُعيد عددًا صحيحًا. | يُعيد التابع <code>round</code> عددًا جذريًا عندما يكون الوسيط <code>ndigits</code> موجبًا، وإلا فسيُعيد عددًا صحيحًا. | ||
| سطر 13: | سطر 15: | ||
===<code>ndigits</code>=== | ===<code>ndigits</code>=== | ||
يحدد عدد المنازل العشرية | يحدد عدد المنازل العشرية | ||
==القيمة المُعادة== | ==القيمة المُعادة== | ||
يعيد التابع <code>round</code> العدد الذي استُدعي معه مُقرّبًا إلى أقرب قيمة مع دقة <code>ndigits</code> منزلًا عشريًا والتي ستكون عددًا جذريًا عندما يكون الوسيط <code>ndigits</code> موجبًا، وإلا فستكون عددًا صحيحًا. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 28: | سطر 29: | ||
Rational('-123.456').round(-1) #=> -120</syntaxhighlight> | Rational('-123.456').round(-1) #=> -120</syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/Rational/rationalize|rationalize]]</code>: يُعيد تقريبًا مبسطًا لقيمة العدد | * التابع <code>[[Ruby/Rational/rationalize|rationalize]]</code>: يُعيد تقريبًا مبسطًا لقيمة العدد. | ||
* التابع <code>[[Ruby/Rational/to_f|to_f]]</code>: يُعيد | * التابع <code>[[Ruby/Rational/to_f|to_f]]</code>: يُعيد العدد على هيئة عدد عشري <code>[[Ruby/Float|Float]]</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 في توثيق روبي الرسمي.] | ||
مراجعة 22:58، 30 أكتوبر 2018
يعيد التابع round العدد الذي استُدعي معه مُقرّبًا إلى أقرب قيمة مع دقة ndigits منزلًا عشريًا (القيمة الافتراضية هي 0).
عندما تكون الدقة سالبة، القيمة التي تُعاد ستكون عددًا صحيحًا مع ndigits.abs صفرًا زائدًا على الأقل.
يُعيد التابع round عددًا جذريًا عندما يكون الوسيط ndigits موجبًا، وإلا فسيُعيد عددًا صحيحًا.
يمكن تمرير وسيط مُسمى (keyword argument) اختياري half بشكل مماثل للتابع Float#round.
البنية العامة
round([ndigits] [, half: mode]) → integer or rational
المعاملات
ndigits
يحدد عدد المنازل العشرية
القيمة المُعادة
يعيد التابع round العدد الذي استُدعي معه مُقرّبًا إلى أقرب قيمة مع دقة ndigits منزلًا عشريًا والتي ستكون عددًا جذريًا عندما يكون الوسيط ndigits موجبًا، وإلا فستكون عددًا صحيحًا.
أمثلة
مثال على استخدام التابع 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
انظر أيضا
- التابع
rationalize: يُعيد تقريبًا مبسطًا لقيمة العدد. - التابع
to_f: يُعيد العدد على هيئة عدد عشريFloat.