php8.5
Home/ Manual/ math / functions/ intdiv

intdiv

PHP function Edit on GitHub ✎

(PHP 7, PHP 8)

Integer division

Description

intdiv(int $num1, int $num2): int

Returns the integer quotient of the division of num1 by num2.

Parameters

num1

Number to be divided.

num2

Number which divides the num1.

Return Values

The integer quotient of the division of num1 by num2.

Errors/Exceptions

If num2 is 0, a DivisionByZeroError exception is thrown. If the num1 is PHP_INT_MIN and the num2 is -1, then an ArithmeticError exception is thrown.

Examples

intdiv() example

php
<?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));
?>

The above example will output:

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

intdiv() Example With Invalid Divisor

php
<?php
try {
    intdiv(PHP_INT_MIN, -1);
} catch (Error $e) {
    echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}

try {
    intdiv(1, 0);
} catch (Error $e) {
    echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}
?>

The above example will output:

output
ArithmeticError: Division of PHP_INT_MIN by -1 is not an integer
DivisionByZeroError: Division by zero

See Also

  • / - Floating-point division
  • % - Integer modulus
  • fmod() - Floating-point modulo

Source: reference/math/functions/intdiv.xml · from the official PHP manual (php/doc-en)