bccomp

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

bccompCompare two arbitrary precision numbers

Опис

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

Compares num1 to num2 and returns the result of the comparison as an integer.

Параметри

num1

The left operand, as a string.

num2

The right operand, as a string.

scale

Необов'язковий параметр, яким вказується кількість знаків після крапки в результаті. Якщо опущено, застосовується межа, що встановлена глобально функцією bcscale(), або ж 0, якщо межа ще не встановлена.

Значення, що повертаються

Returns 0 if both operands are equal, 1 if num1 is greater than num2, -1 otherwise.

Помилки/виключення

This function throws a ValueError in the following cases:

  • num1 or num2 is not a well-formed BCMath numeric string.
  • scale is outside the valid range.

Журнал змін

Версія Опис
8.0.0 scale is now nullable.

Приклади

Приклад #1 bccomp() example

<?php

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

?>