In MongoDB, de $or
aggregatiepijplijnoperator evalueert een of meer expressies en retourneert true
indien van toepassing, evalueer naar true
. Anders retourneert het false
.
Syntaxis
De syntaxis gaat als volgt:
{ $or: [ <expression1>, <expression2>, ... ] }
Voorbeeld
Stel dat we een verzameling hebben met de naam data
met het volgende document:
{ "_id" : 1, "a" : 10, "b" : 2, "c" : 20 }
Dit is wat er gebeurt als we $or
gebruiken om te testen op twee voorwaarden tegen dat document:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
b: 1,
result: { $or: [
{ $gt: [ "$a", 9 ] },
{ $lt: [ "$b", 1 ] }
] }
}
}
]
)
Resultaat:
{ "a" : 10, "b" : 2, "result" : true }
We kunnen zien dat $or
geretourneerd true
, ook al wordt een van de expressies omgezet in false
. Dit komt omdat het true
teruggeeft indien enig van de uitdrukkingen is true
.
Hier is het weer, maar met beide uitdrukkingen die eindigen op false
.
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
b: 1,
result: { $or: [
{ $gt: [ "$a", 20 ] },
{ $lt: [ "$b", 1 ] }
] }
}
}
]
)
Resultaat:
{ "a" : 10, "b" : 2, "result" : false }
Meer dan twee argumenten
Zoals vermeld, $or
accepteert een of meer uitdrukkingen. In het vorige voorbeeld worden twee uitdrukkingen gebruikt. Hier is een voorbeeld dat er drie gebruikt:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
b: 1,
c: 1,
result: { $or: [
{ $gt: [ "$a", 9 ] },
{ $lt: [ "$b", 3 ] },
{ $gt: [ "$c", 30 ] }
] }
}
}
]
)
Resultaat:
{ "a" : 10, "b" : 2, "c" : 20, "result" : true }
In dit geval is het resultaat true
, ook al evalueert de derde waarde false
.
Eén argument
Aangezien $or
een of meer uitdrukkingen accepteert, is het mogelijk om een enkel argument op te geven.
Voorbeeld:
db.data.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
a: 1,
result: { $or: [
{ $gt: [ "$a", 9 ] }
] }
}
}
]
)
Resultaat:
{ "a" : 10, "result" : true }
Nul-, Null- en Ongedefinieerde Waarden
De $or
operator evalueert 0
, null
, en undefined
als false
.
Stel dat we de volgende documenten hebben:
{ "_id" : 2, "a" : 0, "b" : 2 } { "_id" : 3, "a" : 10, "b" : 0 } { "_id" : 4, "a" : 0, "b" : 0 } { "_id" : 5, "a" : null, "b" : 2 } { "_id" : 6, "a" : 10, "b" : null } { "_id" : 7, "a" : null, "b" : null } { "_id" : 8, "a" : undefined, "b" : 2 } { "_id" : 9, "a" : 10, "b" : undefined } { "_id" : 10, "a" : undefined, "b" : undefined }
Dit is wat er gebeurt als we $or
apply toepassen :
db.data.aggregate(
[
{ $match: { _id: { $in: [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ] } } },
{ $project: {
_id: 0,
a: 1,
b: 1,
result: { $or: [ "$a", "$b" ] } }
}
]
)
Resultaat:
{ "a" : 0, "b" : 2, "result" : true } { "a" : 10, "b" : 0, "result" : true } { "a" : 0, "b" : 0, "result" : false } { "a" : null, "b" : 2, "result" : true } { "a" : 10, "b" : null, "result" : true } { "a" : null, "b" : null, "result" : false } { "a" : undefined, "b" : 2, "result" : true } { "a" : 10, "b" : undefined, "result" : true } { "a" : undefined, "b" : undefined, "result" : false }
Hier heb ik het veld gewoon als de uitdrukking gebruikt.
Zo ziet het eruit als we slechts één argument toepassen op de velden die 0
bevatten , null
, en undefined
:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 4, 7, 10 ] } } },
{ $project: {
_id: 0,
a: 1,
result: { $or: [ "$a" ] } }
}
]
)
Resultaat:
{ "a" : 0, "result" : false } { "a" : null, "result" : false } { "a" : undefined, "result" : false }
Alle velden retourneren false
.
Roep $or
. op zonder argumenten
Wanneer aangeroepen zonder argumenten, de $or
operator evalueert naar false
.
Voorbeeld:
db.data.aggregate(
[
{ $match: { _id: { $in: [ 1 ] } } },
{ $project: {
_id: 0,
result: { $or: [ ] } }
}
]
)
Resultaat:
{ "result" : false }