الدالة pow() في بايثون
تعيد الدالة pow() القيمة xy أي ترفع الأساس x إلى القوة y للقيمتين الممرَّرتين إليها، مع إمكانيّة الحصول على باقي القسمة عند تقسيم النّاتج على المُعامل z.
البنية العامة
pow(x, y[, z])
المعاملات
x
الأساس.
y
القوّة.
z
العدد الذي ستُقسم عليه النّتيجة لتُعيد الدّالة باقي القسمة.
عند تمرير قيمة له، فالعمليّة تكون نسخةً تُحسبُ بطريقة أفضل من الجملة pow(x, y) % z.
القيمة المعادة
تُعاد قيمة الأساس x مرفوعًا إلى القوّة y إن لم تُعط قيمة للمُعامل z ويكون الاستدعاء مُكافئًا للعمليّة x**y، وتكون النّتيجة من نوع المُعاملات (بعد إخضاعها إلى قواعد الحساب الثّنائيّة) إلّا إن كان المُعامل الثّاني (أي القوّة) عددًا سالبًا؛ في هذه الحالة، تُحوّل جميع المُعاملات إلى أعداد عشريّة وتكون النّتيجة عددًا عشريًّا. على سبيل المثال، العمليّة 10**2 تُعيد القيمة 100 والعمليّة 10**-2 تُعيد 0.01.
إن كان المُعامل الثّاني عددًا سالبًا، فلا يجوز تمرير قيمة للمُعامل z.
إن مُرّرت قيمة للمُعامل z، فلا بدّ للمُعاملين x وy أن يكونا عددين صحيحين ولا يجوز للمُعامل y أن يكون سالبًا. وسيُعاد باقي القسمة.
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> pow(2, 2) # اثنان أس اثنان يُساوي 4
4
>>> pow(3, 2, 6) # تسعة قسمة ستّة يُساوي واحد ويتبقّى ثلاثة
3