intdiv

    (PHP 7, PHP 8)

    intdiv — 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

    Example #1 intdiv() example

    <?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

    See Also

    • / - Floating-point division
    • % - Integer modulus
    • fmod() - Returns the floating point remainder (modulo) of the division of the arguments - Floating-point modulo

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    43
    AmeenRoss
    9 years ago
    This does indeed seem to be equal to intdiv:

    <?php
    function intdiv_1($a, $b){
    return (    $a - $a % $b) / $b;
    }
    ?>

    However, this isn't:

    <?php
    function intdiv_2($a, $b){
    return     floor($a / $b);
    }
    ?>

    Consider an example where either of the parameters is negative:
    <?php
    $param1     = -10;
    $param2 = 3;
    print_r([
    'modulus' => intdiv_1($param1, $param2),
    'floor' => intdiv_2($param1, $param2),
    ]);

    /**
    * Array
    * (
    * [modulus] => -3
    * [floor] => -4
    * )
    */
    ?>
    up
    6
    oittaa
    2 years ago
    Python style integer division, where the result is always rounded towards minus infinity.

    1 // 2 is 0
    (-1) // 2 is -1
    1 // (-2) is -1
    (-1) // (-2) is 0

    <?php
    function intdiv_py(int $num1, int $num2): int{
    if (    $num1 < 0 xor $num2 < 0){
    $num1 = abs($num1);
    $num2 = abs($num2);
    $remainder = $num1 % $num2;
    return     $remainder ? -1 -($num1 - $remainder) / $num2 : -$num1 / $num2;
    }
    return     intdiv($num1, $num2);
    }

    var_dump(intdiv_py(1, 2)); // 0
    var_dump(intdiv_py(-1, 2)); // -1
    var_dump(intdiv_py(1, -2)); // -1
    var_dump(intdiv_py(-1, -2)); // 0
    ?>
    up
    -2
    sree dot millu at gmail dot com
    4 years ago
    @AmeenRoss
    This does NOT seem to be equal to intdiv:

    <?php
    function intdiv_1($a, $b){
    return (    $a - $a % $b) / $b;
    }
    ?>

    See this example code
    <?php

    $x     = 5.6;
    $y = 1.4 ;

    echo     intdiv($x,$y);

    echo     "\n";

    function     intdiv_1($a, $b){
    return (    $a - $a % $b) / $b;
    }

    echo     intdiv_1($x,$y);
    ?>

    //Output
    5
    4
    ＋add a note
    To Top