PHPのfmod()関数とは？浮動小数点数の剰余を求める方法を解説

PHPのfmod()関数は、被除数（割られる数）を除数（割る数）で割ったときの剰余（あまり）を返す関数です。整数だけでなく、浮動小数点数（float）同士の剰余も計算できるのが特徴で、通常の剰余演算子「%」では扱えない小数の計算に活用できます。

基本構文

fmod(被除数, 除数)

パラメータ

• 被除数（dividend） − 割られる側の数値を指定します。

• 除数（divisor） − 割る側の数値を指定します。

戻り値

被除数を除数で割った結果の剰余（float型）を返します。戻り値は常に被除数と同じ符号になります。なお、除数に0を指定した場合は警告が発生し、NANが返されるので注意が必要です。

使用例

<?php
    $p = 30;
    $q = 9;
    $remainder = fmod($p, $q);
    echo $remainder;
?>

実行結果

3

この例では、30を9で割ると商は3、余りは3となるため、「3」が出力されます。

浮動小数点数での計算例

<?php
    echo fmod(10.5, 3);   // 結果: 1.5
    echo fmod(-10.5, 3);  // 結果: -1.5
?>

「%」演算子との違い

剰余演算子「%」はオペランドを整数に変換してから計算するため、小数を含む計算には使えません。一方、fmod()関数は引数をfloatとして扱うため、次のような違いが生じます。

<?php
    echo 5.5 % 2;      // 結果: 1（整数に変換されて計算される）
    echo fmod(5.5, 2); // 結果: 1.5（小数のまま正確に計算される）
?>

小数を含む剰余計算を行いたい場合は、必ずfmod()関数を使用するようにしましょう。