الفرق بين المراجعتين لصفحة: «Python/round»
إضافة الصّفحة |
ط استبدال النص - 'Python/float-arithmatics' ب'Python/float_arithmatics' |
||
| (3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 12: | سطر 12: | ||
=== <code>ndigits</code> === | === <code>ndigits</code> === | ||
مُعامل اختياريّ يُمثّل عدد الأرقام بعد الفاصلة ويكون عددًا صحيحًا (سواء أكان سالبًا، أو موجبًا، أو صفرًا). إن لم تُمرّر له أيّة قيمة | مُعامل اختياريّ يُمثّل عدد الأرقام بعد الفاصلة ويكون عددًا صحيحًا (سواء أكان سالبًا، أو موجبًا، أو صفرًا). إن لم تُمرّر له أيّة قيمة أو مُرّرت إليه القيمة <code>None</code>، فستُعيد الدّالة أقرب عدد صحيح للمُعامل <code>number</code>. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
| سطر 36: | سطر 35: | ||
== ملاحظات == | == ملاحظات == | ||
* إن كان المُعامل <code>number</code> | * إن كان المُعامل <code>number</code> كائن بايثون عامًّا، فستقوم الدّالة <code>round(number, ndigits)</code> باستدعاء التّابع <code>number.__round__(ndigits)</code>. | ||
* يُمكن لآليّة عمل الدّالة <code>round()</code> أن تكون مُفاجأةً في بعض الحالات، فمثلًا، الاستدعاء <code>round(2.675, 2)</code> يُعطي <code>2.67</code> عوضًا عن القيمة المُتوقّعة <code>2.68</code>. هذه ليست علّة، بل نتيجة للمشاكل والمعوّقات التي تفرضها العمليات الحسابية على الأعداد العشرية. | * يُمكن لآليّة عمل الدّالة <code>round()</code> أن تكون مُفاجأةً في بعض الحالات، فمثلًا، الاستدعاء <code>round(2.675, 2)</code> يُعطي <code>2.67</code> عوضًا عن القيمة المُتوقّعة <code>2.68</code>. هذه ليست علّة، بل نتيجة [[Python/float_arithmatics|للمشاكل والمعوّقات التي تفرضها العمليات الحسابية على الأعداد العشرية]]. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
المراجعة الحالية بتاريخ 07:46، 22 مايو 2018
تعيد الدّالة round() قيمة العدد المُعطى مُقرّبًا حسب عدد الأرقام كتقريب بعد الفاصلة.
البنية العامة
round(number[, ndigits])
المعاملات
number
العدد المُراد تقريبه.
ndigits
مُعامل اختياريّ يُمثّل عدد الأرقام بعد الفاصلة ويكون عددًا صحيحًا (سواء أكان سالبًا، أو موجبًا، أو صفرًا). إن لم تُمرّر له أيّة قيمة أو مُرّرت إليه القيمة None، فستُعيد الدّالة أقرب عدد صحيح للمُعامل number.
القيمة المعادة
عدد مُقرّب حسب المُعاملات المُعطاة.
تُقرّب القيم إلى أقرب مُضاعف من مُضاعفات 10 مرفوعًا إلى قوّة ناقص العدد المُمرّر إلى المُعامل ndigits في الأنواع المُضمّنة في بايثون التّي تدعم الدّالة round()، إن كان مُضاعفان قريبين بنفس المسافة، فسيُقرّب إلى الخيار الزوجي (فمثلًا، كلّ من round(0.5) وround(-0.5) يُساويان 0، و round(1.5) يُساوي 2).
القيمة المُعادة تكون عددًا صحيحًا إن استُدعيَت الدّالة بمُعامل واحد، وإلّا تكون من نوع المُعامل number.
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> 100/3
33.333333333333336
>>> round(100/3, 2)
33.33
>>> round(1.8)
2
>>> round(1.2)
1
ملاحظات
- إن كان المُعامل
numberكائن بايثون عامًّا، فستقوم الدّالةround(number, ndigits)باستدعاء التّابعnumber.__round__(ndigits). - يُمكن لآليّة عمل الدّالة
round()أن تكون مُفاجأةً في بعض الحالات، فمثلًا، الاستدعاءround(2.675, 2)يُعطي2.67عوضًا عن القيمة المُتوقّعة2.68. هذه ليست علّة، بل نتيجة للمشاكل والمعوّقات التي تفرضها العمليات الحسابية على الأعداد العشرية.