diff --git a/website/docs/language/functions/abs.mdx b/website/docs/language/functions/abs.mdx index 49ceef9c93..8f32aa5d6d 100644 --- a/website/docs/language/functions/abs.mdx +++ b/website/docs/language/functions/abs.mdx @@ -2,14 +2,21 @@ page_title: abs - Functions - Configuration Language description: The abs function returns the absolute value of the given number. --- +# abs function reference +This topic provides reference information about the abs function. The abs function returns the absolute value of the given number. +## Introduction +abs returns the absolute value of the given number. If the number is zero or positive, the function returns the value as-is, but if it is negative, it is multiplied by -1 to make it positive before returning it. -# `abs` Function +## Syntax +Use the abs function with the following syntax: -`abs` returns the absolute value of the given number. In other words, if the -number is zero or positive then it is returned as-is, but if it is negative -then it is multiplied by -1 to make it positive before returning it. +``` +abs(number) +``` -## Examples +The number is the number you want the absolute value of. + +In the following example, the function returns the absolute value of 23, 0, and -12.4. ``` > abs(23) @@ -19,3 +26,17 @@ then it is multiplied by -1 to make it positive before returning it. > abs(-12.4) 12.4 ``` + +## Example use case +The following example defines a variable num that is negative. The function outputs the absolute value of num, which is 10. +``` +variable "num" { + default = -10 +} + +output "absolute_value" { + value = abs(var.num) +} +``` +## Related Functions +[signum](/terraform/language/functions/signum) determines the sign of a number, returning a number between -1 and 1 to represent the sign