Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

BigDecimal.compareTo — Comparar valores decimales

`BigDecimal.compareTo` compara valores numéricos sin tener en cuenta las diferencias de escala. Compara el resultado con cero para comprobar el orden o la igualdad numérica.

Versión: Java SE 21

Sintaxis

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

En Java SE 21, el método de instancia compareTo(BigDecimal val) de java.math.BigDecimal implementa el contrato de Comparable<BigDecimal>. Recibe un argumento de tipo BigDecimal; no hay ninguna sobrecarga que acepte directamente un double o un String. Si se pasa null, se lanza NullPointerException.

x.compareTo(y) devuelve un int: -1 si x es numéricamente menor que y, 0 si los valores son iguales o 1 si x es mayor. Compara el resultado con cero, por ejemplo mediante x.compareTo(y) < 0 o x.compareTo(y) == 0. El resultado no es la diferencia entre los números. El contrato general de Comparable solo especifica el signo; BigDecimal garantiza estos tres valores exactos.

La comparación no redondea los valores ni modifica ninguno de los objetos. 2.0 y 2.00 tienen el mismo valor numérico, por lo que compareTo devuelve 0. Sus escalas son distintas (1 y 2), así que equals(Object) devuelve false: exige que coincidan tanto el valor como la escala.

Al aplicar == directamente a dos referencias BigDecimal, el resultado es true si apuntan al mismo objeto o si ambas son null. No se comparan los valores numéricos. Como el orden natural difiere de equals, un TreeSet<BigDecimal> sin comparador personalizado trata 2.0 y 2.00 como un solo elemento.

Ejemplos

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

Las cadenas que se pasan al constructor conservan las escalas `1` y `2` de `a` y `b`. Las dos primeras líneas contrastan la comparación numérica con `equals`; las dos últimas muestran que intercambiar los operandos cambia el signo.

Lecciones relacionadas

  • Java · Lección 69 · Básico · Versión: 2

Fuentes