{% 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)

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

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