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
- 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