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)

to_integer()

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

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

Result: 42, 3, 1

to_float()

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

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

Result: 3.14, 42, 1

to_string()

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

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

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

to_boolean()

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 to_boolean("true"), to_boolean(1), to_boolean("yes")

Result: true, true, true

to_list()

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 to_list("hello")

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

to_map()

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

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

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