CKTIS / Java
BigDecimal.compareTo — Comparer des valeurs décimales
`BigDecimal.compareTo` compare les valeurs numériques sans tenir compte des différences d’échelle. Comparez le résultat à zéro pour déterminer l’ordre ou l’égalité numérique.
Version : Java SE 21
Syntaxe
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 yDans Java SE 21, la méthode d’instance compareTo(BigDecimal val) de java.math.BigDecimal implémente le contrat de Comparable<BigDecimal>. Elle prend un argument de type BigDecimal ; aucune surcharge n’accepte directement un double ou une String. Passer null déclenche une NullPointerException.
x.compareTo(y) renvoie un int : -1 si x est numériquement inférieur à y, 0 si les valeurs sont égales, ou 1 si x est supérieur. Comparez le résultat à zéro, par exemple avec x.compareTo(y) < 0 ou x.compareTo(y) == 0. Ce résultat n’est pas la différence entre les deux nombres. Le contrat général de Comparable ne spécifie que le signe ; BigDecimal garantit ces trois valeurs de retour exactes.
La comparaison n’arrondit aucune valeur et ne modifie aucun objet. 2.0 et 2.00 ont la même valeur numérique : compareTo renvoie donc 0. Leurs échelles diffèrent (1 et 2), donc equals(Object) renvoie false : la valeur et l’échelle doivent toutes deux coïncider.
Appliqué directement à deux références BigDecimal, == donne true si elles désignent le même objet ou si elles valent toutes deux null. Il ne compare pas les valeurs numériques. Comme l’ordre naturel diffère de equals, un TreeSet<BigDecimal> sans comparateur personnalisé traite 2.0 et 2.00 comme un seul élément.
Exemples
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));
}
}
Résultat
0 false -1 1
Les chaînes passées au constructeur conservent les échelles `1` et `2` pour `a` et `b`. Les deux premières lignes opposent la comparaison numérique à `equals` ; les deux dernières montrent qu’inverser les opérandes change le signe du résultat.
Leçons associées
- Java · Leçon 69 · Débutant · Version : 2