Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Math.abs — valor absoluto

Calcula o valor absoluto, compara valores de vírgula flutuante com uma tolerância e tem em conta o caso dos menores valores inteiros.

Versão: Java SE 21

Sintaxe

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) devolve o valor absoluto de a, ou seja, a sua distância a zero, se o resultado puder ser representado no tipo devolvido. É um método estático de java.lang.Math, pelo que não precisas de criar um objeto nem de fazer uma importação. O Java SE 21 disponibiliza quatro sobrecargas, para int, long, float e double. O compilador escolhe a sobrecarga com base no tipo do argumento; o tipo devolvido coincide com o tipo do parâmetro da sobrecarga escolhida.

Atenção aos valores inteiros mínimos: Math.abs(Integer.MIN_VALUE) e Math.abs(Long.MIN_VALUE) devolvem o mesmo valor negativo que receberam, porque o valor positivo correspondente não cabe no tipo. Para detetar o transbordo em vez de obteres um resultado negativo, usa Math.absExact(a) para int ou long: o método lança uma ArithmeticException para o valor mínimo correspondente.

Para float e double, tanto -0.0 como +0.0 dão zero positivo, ambos os infinitos dão infinito positivo e NaN continua a ser NaN.

Para comparar dois valores finitos de vírgula flutuante, usa Math.abs(a - b) <= tolerance. O operador <= inclui o limite: uma diferença igual à tolerância é aceite. Escolhe uma tolerância absoluta finita e não negativa, adequada à escala e às unidades dos dados; não há um valor que sirva para todos os casos. Se a diferença calculada for NaN, a comparação devolve false.

Exemplos

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

Resultado

false
true
7
-2147483648

Devido ao arredondamento em vírgula flutuante, `0.1 + 0.2` não é exatamente igual a `0.3`, mas a diferença está dentro da tolerância de `1e-9`. As duas últimas linhas mostram um resultado `int` habitual e o caso do valor mínimo.

Lições relacionadas

  • Java · Lição 6 · Básico · Versão: 2

Fontes