layout	api-command
language	Python
permalink	api/python/set_union/
command	set_union
related_commands	union difference set_insert set_intersection set_difference union/ difference/ set_insert/ set_intersection/ set_difference/

Command syntax

{% apibody %} array.set_union(array) → array {% endapibody %}

Description

Add a several values to an array and return it as a set (an array with distinct values).

Example: Retrieve Iron Man's equipment list with the addition of some new boots and an arc reactor.

r.table('marvel').get('IronMan')['equipment'].set_union(['newBoots', 'arc_reactor']).run(conn)