docs/api/javascript/document-manipulation/difference.md at master

layout

api-command

language

JavaScript

permalink

api/javascript/difference/

command

difference

array

related_commands

setInsert	setUnion	setIntersection	setDifference	union
set_insert/	set_union/	set_intersection/	set_difference/	union/

Command syntax

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

Remove the elements of one array from another array.

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

r.table('marvel').get('IronMan')('equipment')
  .difference(['Boots'])
  .run(conn, callback)

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

r.table('marvel').get('IronMan')
  .update({
    equipment: r.row('equipment').difference(['Boots'])
  })
  .run(conn, callback)