Path Functions

Example Graph

The following examples run against this graph:

nodes()

Extracts all nodes from a path as a list. Supports index access and slicing.

GQL
MATCH p = ({_id: "P1"})-[]->{1,2}()
RETURN nodes(p)

Index access (0-based, negative indices supported):

GQL
MATCH p = ({_id: "P1"})-[]->{2}()
RETURN nodes(p)[0] AS first, nodes(p)[-1] AS last

Slicing:

GQL
MATCH p = ({_id: "P1"})-[]->{3}()
RETURN nodes(p)[0:2] AS first_two, nodes(p)[1:] AS rest

path_length()

Returns the number of edges in a path.

GQL
MATCH p = ()->{1,3}()
RETURN p, PATH_LENGTH(p) AS length

Result:

pedges()

Collects edges in a path into a list.

GQL
MATCH p = ({_id: "P1"})-[]->{1,2}()
RETURN pedges(p)

Result:

pedgeUuids()

Collects the _uuid values of edges in a path into a list.

GQL
MATCH p = ({_id: "P1"})-[]->{1,2}()
RETURN pedgeUuids(p)

Result:

pnodes()

Collects nodes in a path into a list.

GQL
MATCH p = ({_id: "P1"})-[]->{1,2}()
RETURN pnodes(p)

Result:

pnodeIds()

Collects the _id values of nodes in a path into a list.

GQL
MATCH p = ({_id: "P1"})-[]->{1,2}()
RETURN pnodeIds(p)

Result:

relationships()

Extracts all edges from a path as a list. Supports index access and slicing.

GQL
MATCH p = ({_id: "P1"})-[]->{1,2}()
RETURN relationships(p)

Index access:

GQL
MATCH p = ({_id: "P1"})-[]->{2}()
RETURN relationships(p)[0] AS first_edge

Relationship to Other Path Functions

NOTE

nodes(p)[0].name (chained property access) is not supported. Use nodes(p)[0] to retrieve the node, then access properties separately.