PHPのgmp_cmp()関数とは？2つのGMP数値を比較する方法を解説

はじめに

PHPのgmp_cmp()関数は、任意精度整数（GMP数値）同士を比較するための関数です。通常の整数型では表現できない巨大な数値を扱う際に、2つの数値の大小関係を正確に判定することができます。

構文

gmp_cmp(n1, n2)

パラメータ

• n1 − 比較対象となる最初のGMP数値。PHP 5.6以降ではGMPオブジェクトを指定できます。数値形式の文字列も受け付けます。

• n2 − 比較対象となる2つ目のGMP数値。PHP 5.6以降ではGMPオブジェクトを指定できます。数値形式の文字列も受け付けます。

戻り値

gmp_cmp()関数は、比較結果として以下の整数値を返します。

• 1 − 最初の数値（n1）が大きい場合
• -1 − 2番目の数値（n2）が大きい場合
• 0 − 両方の数値が等しい場合

使用例

それでは、具体的なコード例を見てみましょう。

例1：等しい数値を比較する場合

<?php
    $n1 = "32";
    $n2 = "32";
    $cmpres = gmp_cmp($n1, $n2);
    echo $cmpres;
?>

出力

実行結果は以下のとおりです。

0

両方の数値が等しいため、「0」が出力されます。

例2：異なる数値を比較する場合

<?php
    $n1 = "25";
    $n2 = "30";
    $cmpres = gmp_cmp($n1, $n2);
    echo $cmpres;
?>

出力

実行結果は以下のとおりです。

-1

$n1（25）が$n2（30）より小さいため、「-1」が出力されます。

まとめ

gmp_cmp()関数を使用することで、標準の整数型では表現できない非常に大きな数値でも正確な比較が可能になります。GMP関数群は、暗号処理や科学技術計算など、多倍長整数を必要とする場面で広く活用されています。数値の大小判定が必要な場合は、ぜひこの関数を活用してみてください。