bccomp

(PHP 4, PHP 5, PHP 7, PHP 8)

bccomp — 2 つの任意精度数値を比較する

bccomp(string $num1, string $num2, ?int $scale = null): int

num1 と num2 を比較し、比較結果を整数値で返します。

num1: 左オペランドを表す文字列。
num2: 右オペランドを表す文字列。
scale: 結果の小数点以下の桁数を指定します。null の場合は、 bcscale() 関数でグローバルに設定した桁数をデフォルトとして使用します。それも設定されていない場合は bcmath.scale INI ディレクティブの値を使用します。

ふたつのオペランドが等しければ 0、 num1 が num2 より大きければ戻り値は 1、小さければ -1 を返します。

この関数は、以下の場合に ValueError をスローします:

バージョン	説明
8.0.0	`scale` は、nullable になりました。

例1 bccomp() の例

<?php

echo bccomp('1', '2') . "\n";   // -1
echo bccomp('1.00001', '1', 3); // 0
echo bccomp('1.00001', '1', 5); // 1

?>