PHP 8.4.24 Released!

    BcMath\Number::compare

    (PHP 8 >= 8.4.0)

    BcMath\Number::compare — Compares two arbitrary precision numbers

    Опис

    public function BcMath\Number::compare(BcMath\Number|string|int $num, ?int $scale = null): int

    Compare two arbitrary precision numbers. This method behaves similar to the spaceship operator.

    Параметри

    num
    The value to be compared to.
    scale
    Specify the scale to use for comparison. If null, all digits are used in the comparison.

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

    Returns 0 if the two numbers are equal, 1 if $this is greater than num, -1 otherwise.

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

    This method throws a ValueError in the following cases:

    • num is string and not a well-formed BCMath numeric string
    • scale is outside the valid range

    Приклади

    Приклад #1 BcMath\Number::compare() example when scale is not specified

    <?php
$number = new BcMath\Number('1.234');

var_dump(
    $number->compare(new BcMath\Number('1.234')),
    $number->compare('1.23400'),
    $number->compare('1.23401'),
    $number->compare(1),
);
?>

    Поданий вище приклад виведе:

    int(0)
int(0)
int(-1)
int(1)

    Приклад #2 BcMath\Number::compare() example of explicitly specifying scale

    <?php
$number = new BcMath\Number('1.234');

var_dump(
    $number->compare(new BcMath\Number('1.299'), 1),
    $number->compare('1.24', 2),
    $number->compare('1.22', 2),
    $number->compare(1, 0),
);
?>

    Поданий вище приклад виведе:

    int(0)
int(-1)
int(1)
int(0)

    Прогляньте також

    • bccomp() - Compare two arbitrary precision numbers

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top