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

CKTIS / Java

Math.abs(double) — valor absoluto e tolerância

Calcula o valor absoluto da diferença entre dois valores `double` e verifica se está dentro de uma tolerância, incluindo o limite.

Versão: Java SE 21

Sintaxe

public static double abs(double a)

// Invocation with a double argument:
double magnitude = Math.abs(a);

Math.abs(double) é um método estático de java.lang.Math. Recebe um double e devolve um double. Para valores finitos diferentes de zero, mantém os positivos e devolve o simétrico dos negativos. Uma expressão do tipo double como argumento seleciona esta sobrecarga, e não a de float, int ou long.

Tanto +0.0 como -0.0 dão zero positivo (0.0). Ambos os infinitos dão infinito positivo, e NaN dá NaN.

Para comparar dois montantes sem ter em conta qual é maior, usa Math.abs(actual - expected) <= tolerance com uma tolerance finita e não negativa. A subtração dá a diferença com sinal, Math.abs dá o seu valor absoluto e <= inclui o limite. Se Math.abs devolver NaN ou infinito positivo, a comparação com essa tolerância dá false.

A subtração de valores double pode arredondar o resultado; Math.abs não desfaz esse arredondamento. Quando os montantes exigem aritmética decimal exata, usa BigDecimal e cria os valores diretamente a partir de cadeias de caracteres com os números decimais.

Exemplos

public class AmountTolerance {
    public static void main(String[] args) {
        double actual = 19.75;
        double expected = 20.0;
        double tolerance = 0.25;

        double difference = Math.abs(actual - expected);
        boolean withinTolerance = difference <= tolerance;

        System.out.println(difference);
        System.out.println(withinTolerance);
    }
}

Resultado

0.25
true

`19.75 - 20.0` dá `-0.25`. O método devolve `0.25`, pelo que `0.25 <= 0.25` dá `true`.

Lições relacionadas

  • Java · Lição 19 · Intermédio · Versão: 2

Fontes