difference.md

layout	language	permalink	command	related_commands
api-command	Java	api/java/difference/	difference	setInsert setUnion setIntersection setDifference union set_insert/ set_union/ set_intersection/ set_difference/ union/

Command syntax

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

Description

Remove the elements of one array from another array.

Example: Retrieve Iron Man's equipment list without boots.

r.table("marvel").get("IronMan").g("equipment").difference(r.array("Boots"))
 .run(conn);

Example: Remove Iron Man's boots from his equipment.

r.table("marvel").get("IronMan").g("equipment").update(
    doc -> r.hashMap("equipment",
                     doc.g("equipment").difference(r.array("Boots")))
).run(conn);