CKTIS / Java
Math.abs — valeur absolue
Calculez une valeur absolue, comparez des nombres à virgule flottante avec une tolérance et tenez compte du cas des plus petits entiers.
Version : Java SE 21
Syntaxe
Math.abs(a)
Overloads in java.lang.Math (Java SE 21):
public static int abs(int a)
public static long abs(long a)
public static float abs(float a)
public static double abs(double a)Math.abs(a) renvoie la valeur absolue de a, c’est-à-dire sa distance à zéro, si le résultat est représentable dans le type de retour. Cette méthode statique de java.lang.Math ne nécessite ni objet ni import. Java SE 21 propose quatre surcharges pour int, long, float et double. Le compilateur choisit la surcharge selon le type de l’argument ; le type de retour est celui du paramètre de la surcharge choisie.
Attention aux plus petits entiers : Math.abs(Integer.MIN_VALUE) et Math.abs(Long.MIN_VALUE) renvoient la même valeur négative qu’en entrée, car son opposé positif n’est pas représentable dans le type concerné. Pour détecter le dépassement de capacité au lieu de recevoir un résultat négatif, utilisez Math.absExact(a) avec un int ou un long. La méthode lève une ArithmeticException pour la valeur minimale correspondante.
Pour float et double, -0.0 et +0.0 donnent tous deux un zéro positif, les deux infinis donnent un infini positif, et NaN reste NaN.
Pour comparer deux valeurs finies à virgule flottante, utilisez Math.abs(a - b) <= tolerance. L’opérateur <= inclut la limite : un écart égal à la tolérance est accepté. Choisissez une tolérance absolue finie, positive ou nulle, adaptée à l’ordre de grandeur et aux unités de vos données ; aucune valeur ne convient à tous les cas. Si la différence calculée vaut NaN, la comparaison renvoie false.
Exemples
public class AbsoluteValueDemo {
public static void main(String[] args) {
double actual = 0.1 + 0.2;
double expected = 0.3;
double tolerance = 1e-9;
System.out.println(actual == expected);
System.out.println(Math.abs(actual - expected) <= tolerance);
System.out.println(Math.abs(-7));
System.out.println(Math.abs(Integer.MIN_VALUE));
}
}Résultat
false true 7 -2147483648
À cause des arrondis en virgule flottante, `0.1 + 0.2` n’est pas exactement égal à `0.3`, mais l’écart reste dans la tolérance de `1e-9`. Les deux dernières lignes montrent un résultat `int` ordinaire et le cas de la valeur minimale.
Leçons associées
- Java · Leçon 6 · Débutant · Version : 2
Sources
- Math (Java SE 21 & JDK 21) — abs(int) and absExact(int)
- Math (Java SE 21 & JDK 21) — abs(long) and absExact(long)
- Math (Java SE 21 & JDK 21) — abs(float)
- Math (Java SE 21 & JDK 21) — abs(double)
- Java Language Specification, Java SE 21 — §7.3 Compilation Units
- Java Language Specification, Java SE 21 — §15.20.1 Numerical Comparison Operators