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

CKTIS / Java

Double.compare() : comparer des valeurs double

Comparez deux valeurs primitives `double` en lisant le signe du résultat. La méthode distingue les zéros signés et place `NaN` en dernier dans l’ordre croissant.

Version : Java SE 21

Syntaxe

public static int compare(double d1, double d2)

int order = Double.compare(a, b);

Double.compare() est une méthode statique de java.lang.Double. L’appel Double.compare(a, b) prend deux valeurs primitives double et renvoie un int. Contrairement à la méthode d’instance compareTo(Double), elle s’appelle sans objet receveur. Les deux méthodes utilisent le même ordre.

Examinez le signe du résultat : une valeur négative indique que a précède b, 0 indique que les deux valeurs sont égales selon cet ordre, et une valeur positive indique que a suit b. Ne supposez pas qu’un résultat non nul vaut exactement -1 ou 1.

La méthode définit un ordre total. Hors NaN, les valeurs suivent l’ordre numérique habituel à une différence près : -0.0 précède +0.0, alors que == considère ces deux valeurs primitives comme égales. Toutes les valeurs NaN sont équivalentes pour cette comparaison et se placent après Double.POSITIVE_INFINITY. Si au moins un opérande est NaN, les opérateurs <, <=, >, >= et == appliqués à des valeurs primitives renvoient tous false.

Utilisez cette méthode dans un comparateur pour trier par valeur double dans l’ordre croissant selon ces règles. Elle ne teste pas l’égalité à une tolérance près.

Exemples

public class Main {
    public static void main(String[] args) {
        double nan = Double.NaN;

        System.out.println(Integer.signum(Double.compare(2.5, 7.0)));
        System.out.println(Double.compare(2.5, 2.5));
        System.out.println(Integer.signum(Double.compare(-0.0, +0.0)));
        System.out.println(-0.0 == +0.0);
        System.out.println(Integer.signum(Double.compare(nan, Double.POSITIVE_INFINITY)));
        System.out.println(Double.compare(nan, nan));
        System.out.println(nan == nan);
    }
}

Résultat

-1
0
-1
true
1
0
false

`Integer.signum` ramène le résultat à `-1`, `0` ou `1`. Les deux premières lignes comparent des nombres ordinaires, les deux suivantes opposent l’ordre des zéros signés au résultat de `==`, et les trois dernières montrent la position de `NaN` et sa comparaison avec lui-même.

Leçons associées

  • Java · Leçon 48 · Débutant · Version : 2
  • Java · Leçon 5 · Intermédiaire · Version : 2

Sources