CKTIS / Java
BigDecimal.compareTo — Comparar valores decimais
`BigDecimal.compareTo` compara valores numéricos sem ter em conta diferenças de escala. Compare o resultado com zero para verificar a ordem ou a igualdade numérica.
Versão: Java SE 21
Sintaxe
public int compareTo(BigDecimal val)
// If x and y are BigDecimal values:
x.compareTo(y) < 0 // x is numerically less than y
x.compareTo(y) == 0 // x and y are numerically equal
x.compareTo(y) > 0 // x is numerically greater than yEm Java SE 21, o método de instância compareTo(BigDecimal val) de java.math.BigDecimal implementa o contrato de Comparable<BigDecimal>. Recebe um argumento do tipo BigDecimal; não existe uma sobrecarga que aceite diretamente um double ou uma String. Passar null lança NullPointerException.
x.compareTo(y) devolve um int: -1 se x for numericamente menor do que y, 0 se os valores forem iguais ou 1 se x for maior. Compare o resultado com zero, por exemplo com x.compareTo(y) < 0 ou x.compareTo(y) == 0. O resultado não é a diferença entre os números. O contrato geral de Comparable especifica apenas o sinal; BigDecimal garante estes três valores exatos.
A comparação não arredonda os valores nem altera nenhum dos objetos. 2.0 e 2.00 têm o mesmo valor numérico, pelo que compareTo devolve 0. As escalas são diferentes (1 e 2), pelo que equals(Object) devolve false: exige que coincidam tanto o valor como a escala.
Aplicado diretamente a duas referências BigDecimal, == dá true se apontarem para o mesmo objeto ou se ambas forem null. Não compara os valores numéricos. Como a ordenação natural difere de equals, um TreeSet<BigDecimal> sem um comparador personalizado trata 2.0 e 2.00 como um único elemento.
Exemplos
import java.math.BigDecimal;
public class Main {
public static void main(String[] args) {
BigDecimal a = new BigDecimal("2.0");
BigDecimal b = new BigDecimal("2.00");
BigDecimal c = new BigDecimal("3.0");
System.out.println(a.compareTo(b));
System.out.println(a.equals(b));
System.out.println(a.compareTo(c));
System.out.println(c.compareTo(a));
}
}
Resultado
0 false -1 1
As cadeias de caracteres passadas ao construtor preservam as escalas `1` e `2` de `a` e `b`. As duas primeiras linhas mostram a diferença entre a comparação numérica e `equals`; as duas últimas mostram que trocar os operandos muda o sinal.
Lições relacionadas
- Java · Lição 69 · Básico · Versão: 2