الدالة intdiv()‎ في PHP

(PHP 7)

تعيد الدالة intdiv()‎ العدد الصحيح لحاصل قسمة العددين المُمرَّرين إليها.

الوصف

int intdiv ( int $dividend , int $divisor )

تعيد هذه الدالة العدد الصحيح لحاصل قسمة القيمة العدديَّة للمقسوم dividend على القيمة العدديَّة للمقسوم عليه divisor.

المعاملات

dividend

المقسوم.

divisor

المقسوم عليه.

القيم المعادة

يُعاد العدد الصحيح لحاصل قسمة القيمة العدديَّة للمعامل dividend على القيمة العدديَّة للمعامل divisor.

الأخطاء والاستثناءات

إن كانت قيمة المقسوم عليه هي 0، فسيرمى الاستثناء DivisionByZeroError؛ وإن كانت قيمة المقسوم هي PHP_INT_MIN والمقسوم عليه هي ‎-1، فسيرمى الاستثناء ArithmeticError. راجع صفحة الأخطاء في PHP 7 للمزيد من الوضوح.

أمثلة

المثال 1: استعمال الدالة intdiv()‎

<?php
var_dump(intdiv(3, 2));
var_dump(intdiv(-3, 2));
var_dump(intdiv(3, -2));
var_dump(intdiv(-3, -2));
var_dump(intdiv(PHP_INT_MAX, PHP_INT_MAX));
var_dump(intdiv(PHP_INT_MIN, PHP_INT_MIN));
var_dump(intdiv(PHP_INT_MIN, -1));
var_dump(intdiv(1, 0));
?>

سيُظهر المثال السابق النتيجة التالية:

int(1)
int(-1)
int(-1)
int(1)
int(1)
int(1)

Fatal error: Uncaught ArithmeticError: Division of PHP_INT_MIN by -1 is not an integer in %s on line 8
Fatal error: Uncaught DivisionByZeroError: Division by zero in %s on line 9

انظر أيضًا

• المعامل /: يعيد ناتج قسمة عددين.
• المعامل %: يعيد باقي قسمة عددين.
• الدالة fmod()‎: تعيد باقي قسمة عددين.

مصادر

• صفحة الدالة intdiv في توثيق PHP الرسمي.