bccomp

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

bccomp — 比较两个任意精度的数字

说明

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：

num1 或 num2 不是格式正确的 BCMath 数字字符串。
scale 超出有效范围。

更新日志

版本	说明
8.0.0	现在 `scale` 可以为 null。

示例

示例 #1 bccomp() 示例

<?php

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

?>

参见

BcMath\Number::compare() - Compares two arbitrary precision numbers

发现了问题？

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

＋添加备注

用户贡献的备注 4 notes

down

Robert Lozyniak ¶

15 years ago

Beware that negative zero does not compare equal to positive zero.

down

aaugrin at gmail dot com ¶

7 years ago

BEWARE! left and right operand is string!! so number in E-notation like 9.012E-6  need to be converted with sprintf('%F') to string

down

mm at mobelt dot com ¶

2 months ago

If you want to compare 2 decimals for equality, bccomp does not works as expected:

bccomp("1.000000000000000","0.999999999999999",2)

returns 1

Instead, use

bcsub("1.000000000000000","0.999999999999999",2) == 0

down

-3

m dot kaczanowski at alianet dot pl ¶

15 years ago

Improvement of functions bcmax() and bcmin() originaly written by frank at booksku dot com

<?php

function bcmax() {
$args = func_get_args();
  if (count($args)==0) return false;
$max = $args[0];
  foreach($args as $value) {
    if (bccomp($value, $max)==1) {
$max = $value;
    }
  }
  return $max;
}

function bcmin() {
$args = func_get_args();
  if (count($args)==0) return false;
$min = $args[0];
  foreach($args as $value) {
    if (bccomp($min, $value)==1) {
$min = $value;
    }
  }
  return $min;
}
?>