[
https://issues.apache.org/jira/browse/TINKERPOP-3256?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18143195#comment-18143195
]
ASF GitHub Bot commented on TINKERPOP-3256:
-------------------------------------------
spmallette commented on code in PR #3763:
URL: https://github.com/apache/tinkerpop/pull/3763#discussion_r4542842219
##########
docs/src/reference/the-traversal.asciidoc:
##########
@@ -3388,12 +3388,32 @@ The following `MATCH` patterns are supported:
|`-[:Label]-` |Labeled undirected edge
|`-[e:Label]-` |Named and labeled undirected edge
|`-[e:Label {key: 'value'}]-` |Named, labeled undirected edge with an inline
property filter
+|`-[e:Label]->{m,n}` |Quantified edge that matches a walk of `m` to `n` edges
+|`-[e:Label]->{m}` |Quantified edge that matches a walk of exactly `m` edges
+|`-[e:Label]->{m,}` |Quantified edge that matches a walk of `m` or more edges
+|`-[e:Label]->+` |Quantified edge that matches a walk of one or more edges,
equivalent to `{1,}`
|=========================================================
Multiple comma-separated path patterns are supported in a single `MATCH`
clause. Patterns that share a variable
name are joined on that variable, which must resolve to the same element
across all patterns. There is no `RETURN`
clause — `match()` always returns the full binding `Map` and any projection is
performed with Gremlin steps like
-`select()`.
+`select()`. An undirected edge pattern, quantified or not, matches a self-loop
once, unlike `bothE()`, which returns
+it once for each of its ends.
+
+A quantifier may follow any directed, reverse, or undirected edge, as in
`<-[e:Label]-{m,n}` or
Review Comment:
i feel like this paragraph is really dense. include examples to demonstrate
the various points?
also, a point from `tinker-review` where the blind tester tripped up:
> The reference docs don't say that an anonymous plain edge collapses
parallel edges into one row. So -[]-> returning fewer rows than -[]->{1}
couldn't be predicted.
> Variable-length path patterns
> -----------------------------
>
> Key: TINKERPOP-3256
> URL: https://issues.apache.org/jira/browse/TINKERPOP-3256
> Project: TinkerPop
> Issue Type: Improvement
> Components: gql
> Affects Versions: 4.0.0
> Reporter: Stephen Mallette
> Priority: Major
>
> Patterns like (a)-[:knows*1..3]->(b) are not supported. Add quantified edge
> syntax to GQL.g4 and the executor.
--
This message was sent by Atlassian Jira
(v10.3.26#10030026)
