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