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