hugo/content/en/functions/int.md
Bjørn Erik Pedersen b9bd35d72e Squashed 'docs/' content from commit fdea5430f
git-subtree-dir: docs
git-subtree-split: fdea5430f89dfd849d39212abdf5ace0a4763e5a
2019-10-21 10:22:28 +02:00

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