hugo/docs/content/en/functions/int.md

1.2 KiB

title linktitle description godocref date publishdate lastmod categories menu keywords signature workson hugoversion relatedfuncs deprecated aliases
int int Creates an `int` from the argument passed into the function. 2017-02-01 2017-02-01 2017-02-01
functions
docs
parent
functions
strings
integers
int INPUT
false

Useful for turning strings into numbers.

{{ int "123" }} → 123

{{% note "Usage Note" %}} If the input string is supposed to represent a decimal number, and if it has leading 0's, then those 0's will have to be removed before passing the string to the int function, else that string will be tried to be parsed as an octal number representation.

The strings.TrimLeft function can be used for this purpose.

{{ int ("0987" | strings.TrimLeft "0") }}
{{ int ("00987" | strings.TrimLeft "0") }}

Explanation

The int function eventually calls the ParseInt function from the Go library strconv.

From its documentation:

the base is implied by the string's prefix: base 16 for "0x", base 8 for "0", and base 10 otherwise. {{% /note %}}