PHPのintdiv()関数とは？整数商の求め方と使い方をサンプル付きで解説

定義と使用方法

intdiv() 関数は、2つの整数パラメータを受け取り、その整数商（割り算の結果の整数部分）を返します。x ÷ y の計算結果が商 i、余り r となるとき、次の式が成り立ちます。

x = y × i + r

このとき、intdiv(x, y) は i を返します。余りは切り捨てられ、商のみが得られる点に注意してください。

構文

intdiv ( int $x , int $y ) : int

パラメータ

戻り値

PHP の intdiv() 関数は、x を y で割った際の整数商を返します。両方の引数が正であるか、または両方が負である場合、戻り値は正の整数になります。

対応バージョン

この関数は PHP 7 以降で利用可能です。

使用例：分子が分母より小さい場合

次の例では、分子が分母より小さい場合に、intdiv() 関数が 0 を返すことを示しています。

<?php
    $x=10;
    $y=3;
    $r=intdiv($x, $y);
    echo "intdiv(" . $x . "," . $y . ") = " . $r . "\n";
    $r=intdiv($y, $x);
    echo "intdiv(" . $y . "," . $x . ") = " . $r;
?>

出力結果

上記のコードを実行すると、次のような結果になります。

intdiv(10,3) = 3
intdiv(3,10) = 0

使用例：符号が異なる場合

次の例では、分子または分母のどちらか一方が負の場合、intdiv() 関数が負の整数を返すことを示しています。

<?php
    $x=10;
    $y=3;
    $r=intdiv($x, $y);
    echo "intdiv(" . $x . "," . $y . ") = " . $r . "\n";
    $x=10;
    $y=-3;
    $r=intdiv($x, $y);
    echo "intdiv(" . $x . "," . $y . ") = " . $r . "\n";
    $x=-10;
    $y=3;
    $r=intdiv($x, $y);
    echo "intdiv(" . $x . "," . $y . ") = " . $r . "\n";
    $x=-10;
    $y=-3;
    $r=intdiv($x, $y);
    echo "intdiv(" . $x . "," . $y . ") = " . $r ;
?>

出力結果

上記のコードを実行すると、次のような結果になります。

intdiv(10,3) = 3
intdiv(10,-3) = -3
intdiv(-10,3) = -3
intdiv(-10,-3) = 3

使用例：分母がゼロの場合

次の例では、分母が 0 であるため、DivisionByZeroError 例外が発生します。

<?php
    $x=10;
    $y=0;
    $r=intdiv($x, $y);
    echo "intdiv(" . $x . "," . $y . ") = " . $r . "\n";
?>

出力結果

上記のコードを実行すると、次のような致命的エラーが発生します。

PHP Fatal error: Uncaught DivisionByZeroError: Division by zero

使用例：小数を含む引数の場合

引数に小数が含まれる場合は小数部分が無視され、整数部分のみに対して intdiv() 関数が適用されます。

<?php
    $x=2.90;
    $y=1.90;
    $r=intdiv($x, $y);
    echo "intdiv(" . $x . "," . $y . ") = " . $r . "\n";
?>

出力結果

上記のコードを実行すると、次のような結果になります。

intdiv(2.9,1.9) = 2