Type Conversion Functions

cast()

Converts a value to the specified type.

Supported target types:

GQL
RETURN cast(1 AS STRING), cast("42" AS INT), cast("true" AS BOOL)

toInteger()

Converts a value to an integer. Returns null if conversion is not possible.

GQL
RETURN toInteger("42"), toInteger(3.7), toInteger(true)

Result: 42, 3, 1

toFloat()

Converts a value to a float. Returns null if conversion is not possible.

GQL
RETURN toFloat("3.14"), toFloat(42), toFloat(true)

Result: 3.14, 42, 1

toString()

Converts a value to a string. Returns null if conversion is not possible.

GQL
RETURN toString(42), toString(3.14), toString(true)

Result: "42", "3.14", "true"

toBoolean()

Converts a value to a boolean. Returns null if conversion is not possible. Accepted string values: "true", "t", "yes", "y", "1" for true; "false", "f", "no", "n", "0" for false (case-insensitive).

GQL
RETURN toBoolean("true"), toBoolean(1), toBoolean("yes")

Result: true, true, true

toList()

Converts a value to a list. Strings are split into a list of characters. Paths are converted to a list of alternating nodes and edges. Other values are wrapped in a single-element list.

GQL
RETURN toList("hello")

Result: ["h", "e", "l", "l", "o"]

toMap()

Creates a record (map) from key-value pairs.

GQL
RETURN toMap("name", "Alice", "age", 30)

Result: {"name": "Alice", "age": 30}