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