Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 y

Em 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

Fontes