BcMath\Number::compare

(PHP 8 >= 8.4.0)

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

说明

public 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() - 比较两个任意精度的数字

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

BcMath\Number::compare

说明

参数

返回值

错误／异常

示例

参见

发现了问题？

用户贡献的备注