Skip to content

Commit

Permalink
Merge branch '3.7-dev'
Browse files Browse the repository at this point in the history
  • Loading branch information
spmallette committed Jun 12, 2024
2 parents ae9a5c4 + ad69f77 commit 8fc71d8
Showing 1 changed file with 6 additions and 4 deletions.
10 changes: 6 additions & 4 deletions docs/src/reference/the-traversal.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -2777,15 +2777,17 @@ link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gre
[[merge-step]]
=== Merge Step
The `merge()`-step (*map*) merges the elements of the incoming list traverser and the provided list argument into one
list. This is also known as the union operation. This step only expects list data (array or Iterable) and will throw
an `IllegalArgumentException` if any other type is encountered (including `null`). This differs from the `combine()`-step
in that it doesn't allow duplicates.
The `merge()`-step (*map*) combines collections like lists and maps. It expects an incoming traverser to contain a
collection objection and will combine that object with its specified argument which must be of a matching type. This is
also known as the union operation. If the incoming traverser or its associated argument do not meet the expected type,
the step will throw an `IllegalArgumentException` if any other type is encountered (including `null`). This step differs
from the `combine()`-step in that it doesn't allow duplicates.
[gremlin-groovy,modern]
----
g.V().values("name").fold().merge(["james","jen","marko","vadas"])
g.V().values("name").fold().merge(__.constant("james").fold())
g.V().hasLabel('software').elementMap().merge([year:2009])
----
*Additional References*
Expand Down

0 comments on commit 8fc71d8

Please sign in to comment.