Dans MongoDB, le $ceil
l'opérateur de pipeline d'agrégation renvoie le plus petit entier supérieur ou égal au nombre spécifié.
$ceil
accepte toute expression valide qui se résout en un nombre.
Exemple
Supposons que nous ayons une collection appelée test
avec les documents suivants :
{ "_id" : 1, "data" : 1.5 } { "_id" : 2, "data" : 1.01 } { "_id" : 3, "data" : -1.5 } { "_id" : 4, "data" : -1.01 } { "_id" : 5, "data" : 1 }
Nous pouvons utiliser le $ceil
opérateur pour retourner le plafond de la data
champ :
db.test.aggregate(
[
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Résultat :
{ "_id" : 1, "ceiling" : 2 } { "_id" : 2, "ceiling" : 2 } { "_id" : 3, "ceiling" : -1 } { "_id" : 4, "ceiling" : -1 } { "_id" : 5, "ceiling" : 1 }
Valeurs nulles
Les valeurs nulles renvoient null
lors de l'utilisation du $ceil
opérateur.
Supposons que nous ajoutions le document suivant à notre collection :
{ "_id" : 6, "data" : null }
Appliquons le $ceil
opérateur sur ce document :
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Résultat :
{ "_id" : 6, "ceiling" : null }
Nous pouvons voir que le résultat est null
.
Valeurs NaN
Si l'argument se résout en NaN
, $ceil
renvoie NaN
.
Exemple :
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$data" * 1 }
}
}
]
)
Résultat :
{ "_id" : 1, "ceiling" : NaN }
Champs inexistants
Si le $ceil
l'opérateur est appliqué sur un champ qui n'existe pas, null
est renvoyé.
Exemple :
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$age" }
}
}
]
)
Résultat :
{ "_id" : 1, "ceiling" : null }