Laravel Live Japan

bccomp

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

bccompCompara dois números de precisão arbitrária

Descrição

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

Compara num1 com num2 e retorna o resultado da comparação como um inteiro.

Parâmetros

num1

O operando da esquerda, como uma string.

num2

O operando da direita, como uma string.

scale
Este parâmetro é usado para definir o número de dígitos após o separador de decimais do resultado. Se for null, será usada a escala padrão definida com bcscale(), ou será usado o valor da diretiva INI bcmath.scale.

Valor Retornado

Retorna 0 se ambos os operandos forem iguais, 1 se num1 for maior que num2, -1 para o restante.

Erros/Exceções

Esta função lança uma exceção ValueError nos seguintes casos:

  • num1 ou num2 não for uma string numérica BCMath bem formada.
  • scale estiver fora do intervalo válido.

Registro de Alterações

Versão Descrição
8.0.0 scale pode ser nulo.

Exemplos

Exemplo #1 Exemplo de bccomp()

<?php

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

?>

Veja Também

adicionar nota

Notas de Usuários 4 notes

up
26
Robert Lozyniak
15 years ago
Beware that negative zero does not compare equal to positive zero.
up
16
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
up
-2
m dot kaczanowski at alianet dot pl
16 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;
}
?>
up
-1
mm at mobelt dot com
11 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
To Top