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 }