nExpNuméricoObrigatório
Expressão numérica que será avaliada para obtenção do valor absoluto.
FUNçãOPublicado
Abs
Abs( <nExp> )Retorna o valor absoluto de uma expressão numérica.
Visão geral
Abs() avalia uma expressão numérica e devolve seu valor absoluto, sempre positivo ou zero. É útil para calcular diferenças, tolerâncias, saldos de comparação e outras regras em que a distância entre dois números importa mais que o sinal.
Sintaxe
Abs( <nExp> )Parâmetros
Diferença absoluta
User Function ExAbs()
Local nLugares := 12
Local nPessoas := 15
Local nDiferenca := Abs(nLugares - nPessoas)
MsgInfo("Diferença: " + CValToChar(nDiferenca))
ReturnResultado esperado
Mesmo quando nLugares - nPessoas resulta em número negativo, Abs() retorna a diferença positiva.
Valor absoluto de número negativo
User Function Abs2()
Local nValue := -123.45
MsgInfo( Abs( nValue ) ) // Resultado: 123.45
ReturnResultado esperado
A função remove o sinal negativo e apresenta 123.45.
- Use quando o sinal não importar para a regra.
- É uma forma simples de obter a diferença positiva entre dois números sem saber previamente qual deles é maior.
- Pela definição matemática, se x for maior ou igual a zero o retorno é x; se x for menor que zero o retorno é -x.
- A referência TDN informa abrangência histórica em Advanced Protheus 6.09, Advanced Protheus 7.10, Microsiga Protheus 8.11 e Protheus 10.
- Não use Abs() para esconder diferença contábil indevida; trate a origem do sinal quando ele tiver significado.
- Valide valores nulos ou não numéricos antes do cálculo.
- Em regras financeiras, confirme se transformar valores negativos em positivos não altera o sentido de crédito, débito, entrada ou saída.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.