Conversions API

Functions for converting between types.

num(value)

Converts a string to a number. Leading and trailing whitespace is trimmed before parsing.

value (string) — the string to parse

Returns: number

Errors: if value is not a string, is empty, or is not a valid number format.

num("42")        // 42
num("3.14")      // 3.14
num("  -7  ")    // -7
num("1e10")      // 10000000000

str(value)

Converts any value to its string representation.

str(42)          // "42"
str(3.14)        // "3.14"
str(true)        // "true"
str(null)        // "null"
str([1, 2, 3])   // "[1, 2, 3]"

str(format, ...)

Formats a string using a format template and arguments. Supports up to 25 arguments after the format string.

Specifier	Type	Description
`%s`	string	Insert a string value
`%n`	number	Insert a number
`%b`	boolean	Insert `true` or `false`
`%v`	any	Insert any value’s string representation
`%%`	—	Literal `%` character

str("Hello, %s!", "world")              // "Hello, world!"
str("%s is %n years old", "Alice", 30)  // "Alice is 30 years old"
str("Result: %b", true)                 // "Result: true"
str("Value: %v", [1, 2])               // "Value: [1, 2]"
str("100%%")                            // "100%"