Home Original page

docs/api/java/document-manipulation/difference.md at master · rethinkdb/docs

Latest commit

layout api-command
language Java
permalink api/java/difference/
command difference
related_commands
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);