الفرق بين المراجعتين ل"Ruby/Integer/round"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>round</code> الخاص بالصنف <code>Integer</code> في روبي}}</noinclude> تصنيف: Ruby تصني...') |
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق) |
||
| (مراجعتان متوسطتان بواسطة مستخدم واحد آخر غير معروضتين) | |||
| سطر 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> | ||
| سطر 18: | سطر 10: | ||
===<code>ndigits</code>=== | ===<code>ndigits</code>=== | ||
| − | عدد يحدد الدقة. | + | عدد يحدد الدقة. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <code>ndigits.abs</code> صفر إضافي على الأقل. أمَّا في حال كانت قيمة <code>ndigits</code> منعدمة أو موجبة، فسيعيد التابع <code>round</code> العدد الذي استُدعي معه. القيمة الافتراضية لهذا المعامل هي: 0. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع <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>round</code>: | |
<syntaxhighlight lang="ruby">1.round #=> 1 | <syntaxhighlight lang="ruby">1.round #=> 1 | ||
1.round(2) #=> 1 | 1.round(2) #=> 1 | ||
15.round(-1) #=> 20 | 15.round(-1) #=> 20 | ||
(-15).round(-1) #=> -20 | (-15).round(-1) #=> -20 | ||
| − | </syntaxhighlight> | + | |
| + | 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</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: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه.