| --- | |
| sidebar_label: parseint | |
| description: >- | |
| The parseint function parses the given string as a representation of an | |
| integer. | |
| --- | |
| # `parseint` Function | |
| `parseint` parses the given string as a representation of an integer in | |
| the specified base and returns the resulting number. The base must be between 2 | |
| and 62 inclusive. | |
| All bases use the arabic numerals 0 through 9 first. Bases between 11 and 36 | |
| inclusive use case-insensitive latin letters to represent higher unit values. | |
| Bases 37 and higher use lowercase latin letters and then uppercase latin | |
| letters. | |
| If the given string contains any non-digit characters or digit characters that | |
| are too large for the given base then `parseint` will produce an error. | |
| ## Examples | |
| ``` | |
| > parseint("100", 10) | |
| 100 | |
| > parseint("FF", 16) | |
| 255 | |
| > parseint("-10", 16) | |
| -16 | |
| > parseint("1011111011101111", 2) | |
| 48879 | |
| > parseint("aA", 62) | |
| 656 | |
| > parseint("12", 2) | |
| Error: Invalid function argument | |
| Invalid value for "number" parameter: cannot parse "12" as a base 2 integer. | |
| ``` | |
| ## Related Functions | |
| * [`format`](../../language/functions/format.mdx) can format numbers and other values into strings, | |
| with optional zero padding, alignment, etc. |