Method union

src/main/java/net/starlark/java/eval/StarlarkSet.java:586–613

(Tuple others, StarlarkThread thread)

  }

  @StarlarkMethod(
      name = "union",
      doc =
"""
Returns a new mutable set containing the union of this set with others.

<p>If <code>s</code> and <code>t</code> are sets, <code>s.union(t)</code> is equivalent to
<code>s | t</code>; however, note that the <code>|</code> operation requires both sides to be sets,
while the <code>union</code> method also accepts sequences and dicts.

<p>It is permissible to call <code>union</code> without any arguments; this returns a copy of the
set.

<p>For example,
<pre class=language-python>
set([1, 2]).union([2, 3])                    # set([1, 2, 3])
set([1, 2]).union([2, 3], {3: "a", 4: "b"})  # set([1, 2, 3, 4])
</pre>
""",
      extraPositionals = @Param(name = "others", doc = "Collections of hashable elements."),
      useStarlarkThread = true)
  public StarlarkSet<?> union(Tuple others, StarlarkThread thread) throws EvalException {
    LinkedHashSet<Object> newContents = new LinkedHashSet<>(contents);
    for (Object other : others) {
      newContents.addAll(toHashableCollection(other, "union argument"));
    }
    return wrapOrImmutableCopy(thread.mutability(), newContents);
  }

  @StarlarkMethod(
      name = "intersection",