Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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 y

Dans 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

Sources