math functions

A set of basic math functions to be able to perform simple arithmetic operations with gomplate.

Supported input

In general, any input will be converted to the correct input type by the various functions in this package, and an appropriately-typed value will be returned type. Special cases are documented.

In addition to regular base-10 numbers, integers can be specified as octal (prefix with 0) or hexadecimal (prefix with 0x).

Decimal/floating-point numbers can be specified with optional exponents.

Some examples demonstrating this:

$ NUM=50 gomplate -i '{{ div (getenv "NUM") 10 }}'
5
$ gomplate -i '{{ add "0x2" "02" "2.0" "2e0" }}'
8
$ gomplate -i '{{ add 2.5 2.5 }}'
5.0

math.Abs

Returns the absolute value of a given number. When the input is an integer, the result will be an int64, otherwise it will be a float64.

Added in gomplate v2.6.0

Usage

math.Abs num

Arguments

Examples

$ gomplate -i '{{ math.Abs -3.5 }} {{ math.Abs 3.5 }} {{ math.Abs -42 }}'
3.5 3.5 42

math.Add

Alias: add

Adds all given operators. When one of the inputs is a floating-point number, the result will be a float64, otherwise it will be an int64.

Added in gomplate v2.2.0

Usage

math.Add n...

Arguments

Examples

$ gomplate -i '{{ math.Add 1 2 3 4 }} {{ math.Add 1.5 2 3 }}'
10 6.5

math.Ceil

Returns the least integer value greater than or equal to a given floating-point number. This wraps Go’s math.Ceil.

Note: the return value of this function is a float64 so that the special-cases NaN and Inf can be returned appropriately.

Added in gomplate v2.6.0

Usage

math.Ceil num

Arguments

Examples

$ gomplate -i '{{ range (coll.Slice 5.1 42 "3.14" "0xFF" "NaN" "Inf" "-0") }}ceil {{ printf "%#v" . }} = {{ math.Ceil . }}{{"\n"}}{{ end }}'
ceil 5.1 = 6
ceil 42 = 42
ceil "3.14" = 4
ceil "0xFF" = 255
ceil "NaN" = NaN
ceil "Inf" = +Inf
ceil "-0" = 0

math.Div

Alias: div

Divide the first number by the second. Division by zero is disallowed. The result will be a float64.

Added in gomplate v2.2.0

Usage

math.Div a b

b | math.Div a

Arguments

Examples

$ gomplate -i '{{ math.Div 8 2 }} {{ math.Div 3 2 }}'
4 1.5

math.Floor

Returns the greatest integer value less than or equal to a given floating-point number. This wraps Go’s math.Floor.

Note: the return value of this function is a float64 so that the special-cases NaN and Inf can be returned appropriately.

Added in gomplate v2.6.0

Usage

math.Floor num

Arguments

Examples

$ gomplate -i '{{ range (coll.Slice 5.1 42 "3.14" "0xFF" "NaN" "Inf" "-0") }}floor {{ printf "%#v" . }} = {{ math.Floor . }}{{"\n"}}{{ end }}'
floor 5.1 = 4
floor 42 = 42
floor "3.14" = 3
floor "0xFF" = 255
floor "NaN" = NaN
floor "Inf" = +Inf
floor "-0" = 0

math.IsFloat

Returns whether or not the given number can be interpreted as a floating-point literal, as defined by the Go language reference.

Note: If a decimal point is part of the input number, it will be considered a floating-point number, even if the decimal is 0.

Added in gomplate v2.6.0

Usage

math.IsFloat num

Arguments

Examples

$ gomplate -i '{{ range (coll.Slice 1.0 "-1.0" 5.1 42 "3.14" "foo" "0xFF" "NaN" "Inf" "-0") }}{{ if (math.IsFloat .) }}{{.}} is a float{{"\n"}}{{ end }}{{end}}'
1 is a float
-1.0 is a float
5.1 is a float
3.14 is a float
NaN is a float
Inf is a float

math.IsInt

Returns whether or not the given number is an integer.

Added in gomplate v2.6.0

Usage

math.IsInt num

Arguments

Examples

$ gomplate -i '{{ range (coll.Slice 1.0 "-1.0" 5.1 42 "3.14" "foo" "0xFF" "NaN" "Inf" "-0") }}{{ if (math.IsInt .) }}{{.}} is an integer{{"\n"}}{{ end }}{{end}}'
42 is an integer
0xFF is an integer
-0 is an integer

math.IsNum

Returns whether the given input is a number. Useful for if conditions.

Added in gomplate v2.6.0

Usage

math.IsNum in

Arguments

Examples

$ gomplate -i '{{ math.IsNum "foo" }} {{ math.IsNum 0xDeadBeef }}'
false true

math.Max

Returns the largest number provided. If any values are floating-point numbers, a float64 is returned, otherwise an int64 is returned. The same special-cases as Go’s math.Max are followed.

Added in gomplate v2.6.0

Usage

math.Max nums...

Arguments

Examples

$ gomplate -i '{{ math.Max 0 8.0 4.5 "-1.5e-11" }}'
8

math.Min

Returns the smallest number provided. If any values are floating-point numbers, a float64 is returned, otherwise an int64 is returned. The same special-cases as Go’s math.Min are followed.

Added in gomplate v2.6.0

Usage

math.Min nums...

Arguments

Examples

$ gomplate -i '{{ math.Min 0 8 4.5 "-1.5e-11" }}'
-1.5e-11

math.Mul

Alias: mul

Multiply all given operators together.

Added in gomplate v2.2.0

Usage

math.Mul n...

Arguments

Examples

$ gomplate -i '{{ math.Mul 8 8 2 }}'
128

math.Pow

Alias: pow

Calculate an exponent - bⁿ. This wraps Go’s math.Pow. If any values are floating-point numbers, a float64 is returned, otherwise an int64 is returned.

Added in gomplate v2.2.0

Usage

math.Pow b n

Arguments

Examples

$ gomplate -i '{{ math.Pow 10 2 }}'
100
$ gomplate -i '{{ math.Pow 2 32 }}'
4294967296
$ gomplate -i '{{ math.Pow 1.5 2 }}'
2.2

math.Rem

Alias: rem

Return the remainder from an integer division operation.

Added in gomplate v2.2.0

Usage

math.Rem a b

b | math.Rem a

Arguments

Examples

$ gomplate -i '{{ math.Rem 5 3 }}'
2
$ gomplate -i '{{ math.Rem -5 3 }}'
-2

math.Round

Returns the nearest integer, rounding half away from zero.

Note: the return value of this function is a float64 so that the special-cases NaN and Inf can be returned appropriately.

Added in gomplate v2.6.0

Usage

math.Round num

Arguments

Examples

$ gomplate -i '{{ range (coll.Slice -6.5 5.1 42.9 "3.5" 6.5) }}round {{ printf "%#v" . }} = {{ math.Round . }}{{"\n"}}{{ end }}'
round -6.5 = -7
round 5.1 = 5
round 42.9 = 43
round "3.5" = 4
round 6.5 = 7

math.Seq

Alias: seq

Return a sequence from start to end, in steps of step. Can handle counting down as well as up, including with negative numbers.

Note that the sequence may not end at end, if end is not divisible by step.

Added in gomplate v2.2.0

Usage

math.Seq [start] end [step]

Arguments

Examples

$ gomplate -i '{{ range (math.Seq 5) }}{{.}} {{end}}'
1 2 3 4 5

$ gomplate -i '{{ conv.Join (math.Seq 10 -3 2) ", " }}'
10, 8, 6, 4, 2, 0, -2

math.Sub

Alias: sub

Subtract the second from the first of the given operators. When one of the inputs is a floating-point number, the result will be a float64, otherwise it will be an int64.

Added in gomplate v2.2.0

Usage

math.Sub a b

b | math.Sub a

Arguments

Examples

$ gomplate -i '{{ math.Sub 3 1 }}'
2