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 yEn 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