WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Math.abs — Absolutbetrag

Berechne den Betrag einer Zahl, vergleiche Gleitkommawerte mit einer Toleranz und beachte den Sonderfall der kleinsten Ganzzahlwerte.

Version: Java SE 21

Syntax

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) gibt den Betrag von a zurück, also den Abstand zu null, sofern das Ergebnis im Rückgabetyp darstellbar ist. Die Methode ist statisch und gehört zu java.lang.Math. Du brauchst weder ein Objekt noch einen Import. Java SE 21 bietet vier Überladungen für int, long, float und double. Der Compiler wählt die Überladung anhand des Argumenttyps aus; der Rückgabetyp entspricht dem Parametertyp der gewählten Überladung.

Bei den kleinsten Ganzzahlwerten ist Vorsicht nötig: Math.abs(Integer.MIN_VALUE) und Math.abs(Long.MIN_VALUE) geben denselben negativen Wert zurück, den sie erhalten haben, weil der entsprechende positive Wert nicht in den Typ passt. Wenn du einen Überlauf erkennen willst, statt ein negatives Ergebnis zu erhalten, verwende Math.absExact(a) für int oder long. Beim jeweiligen Minimalwert löst die Methode eine ArithmeticException aus.

Für float und double ergeben sowohl -0.0 als auch +0.0 positive null. Beide Unendlichkeiten ergeben positive Unendlichkeit, und NaN bleibt NaN.

Zwei endliche Gleitkommawerte kannst du mit Math.abs(a - b) <= tolerance vergleichen. Der Operator <= schließt die Grenze ein: Eine Differenz, die genau der Toleranz entspricht, ist zulässig. Wähle eine endliche, nichtnegative absolute Toleranz passend zur Größenordnung und zu den Einheiten deiner Daten; kein Wert passt immer. Ist die berechnete Differenz NaN, ergibt der Vergleich false.

Beispiele

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));
    }
}

Ergebnis

false
true
7
-2147483648

Durch Gleitkommarundung ist `0.1 + 0.2` nicht exakt gleich `0.3`, aber die Differenz liegt innerhalb der Toleranz von `1e-9`. Die letzten beiden Zeilen zeigen ein gewöhnliches `int`-Ergebnis und den Sonderfall des Minimalwerts.

Zugehörige Lektionen

  • Java · Lektion 6 · Grundlagen · Version: 2

Quellen