$not (aggregation)

Definition

  • $not
  • Evaluates a boolean and returns the opposite boolean value; i.e.when passed an expression that evaluates to true,$not returns false; when passed an expression thatevaluates to false, $not returns true.

$not has the following syntax:

  1. { $not: [ <expression> ] }

For more information on expressions, seeExpressions.

Behavior

In addition to the false boolean value, $not evaluatesas false the following: null, 0, and undefinedvalues. The $not evaluates all other values as true,including non-zero numeric values and arrays.

Example Result
{ $not: [ true ] } false
{ $not: [ [ false ] ] } false
{ $not: [ false ] } true
{ $not: [ null ] } true
{ $not: [ 0 ] } true

Example

Consider an inventory collection with the following documents:

  1. { "_id" : 1, "item" : "abc1", description: "product 1", qty: 300 }
  2. { "_id" : 2, "item" : "abc2", description: "product 2", qty: 200 }
  3. { "_id" : 3, "item" : "xyz1", description: "product 3", qty: 250 }
  4. { "_id" : 4, "item" : "VWZ1", description: "product 4", qty: 300 }
  5. { "_id" : 5, "item" : "VWZ2", description: "product 5", qty: 180 }

The following operation uses the $not operator todetermine if qty is not greater than 250:

  1. db.inventory.aggregate(
  2. [
  3. {
  4. $project:
  5. {
  6. item: 1,
  7. result: { $not: [ { $gt: [ "$qty", 250 ] } ] }
  8. }
  9. }
  10. ]
  11. )

The operation returns the following results:

  1. { "_id" : 1, "item" : "abc1", "result" : false }
  2. { "_id" : 2, "item" : "abc2", "result" : true }
  3. { "_id" : 3, "item" : "xyz1", "result" : true }
  4. { "_id" : 4, "item" : "VWZ1", "result" : false }
  5. { "_id" : 5, "item" : "VWZ2", "result" : true }