Dans MongoDB, le $acosh
L'opérateur de pipeline d'agrégation renvoie l'arccosinus hyperbolique (cosinus hyperbolique inverse) d'une valeur, mesurée en radians.
$acosh
accepte toute expression valide qui se résout en un nombre entre 1
et +Infinity
.
Le $acosh
L'opérateur a été introduit dans MongoDB 4.2.
Exemple
Supposons que nous ayons une collection appelée test
avec le document suivant :
{ "_id" : 1, "data" : 3 }
Nous pouvons utiliser le $acosh
opérateur pour renvoyer l'arccosinus hyperbolique des data
champ :
db.test.aggregate(
[
{ $project: {
_id: 0,
hyperbolicArccosine: { $acosh: "$data" }
}
}
]
)
Résultat :
{ "hyperbolicArccosine" : 1.762747174039086 }
Par défaut, le $acosh
l'opérateur renvoie les valeurs sous la forme d'un double
, mais il peut également renvoyer des valeurs sous forme décimale de 128 bits tant que l'expression se résout en une valeur décimale de 128 bits.
Convertir en degrés
Comme mentionné, $acosh
renvoie son résultat en radians. Vous pouvez utiliser le $radiansToDegrees
opérateur si vous voulez le résultat en degrés.
Exemple :
db.test.aggregate(
[
{ $project: {
_id: 0,
radians: { $acosh: "$data" },
degrees: { $radiansToDegrees: { $acosh: "$data" } }
}
}
]
)
Résultat :
{ "radians" : 1.762747174039086, "degrees" : 100.99797342105244 }
Dans cet exemple, le premier champ présente le résultat en radians et le second le présente en degrés.
Valeurs hors plage
Fournir une valeur hors plage à $acosh
entraînera une erreur.
Supposons que nous ajoutions le document suivant à la collection :
{ "_id" : 2, "data" : 0 }
Exécutons maintenant $acosh
par rapport aux data
champ :
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
radians: { $acosh: "$data" }
}
}
]
)
Résultat :
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $acosh to 0, value must in [1,inf]", "code" : 50989, "codeName" : "Location50989" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:618:17 [email protected]/mongo/shell/assert.js:708:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1046:12 @(shell):1:1
Comme l'indique le message d'erreur, la valeur doit être comprise entre 1
et +Infinity
.
Valeurs nulles
Les valeurs nulles renvoient null
lors de l'utilisation du $acosh
opérateur.
Supposons que nous ajoutions le document suivant à notre collection :
{ "_id" : 3, "data" : null }
Exécutons le $acos
opérateur sur ce document :
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: "$data" }
}
}
]
)
Résultat :
{ "result" : null }
Nous pouvons voir que le résultat est null
.
Valeurs NaN
Si l'argument se résout en NaN
, $acosh
renvoie NaN
.
Exemple :
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: 1 * "string" }
}
}
]
)
Résultat :
{ "result" : NaN }
Dans ce cas, j'ai essayé de multiplier un nombre par une chaîne, ce qui a donné NaN
être retourné.
Infini
Si l'argument se résout en Infinity
, le $acosh
l'opérateur renvoie Infinity
.
Exemple :
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: Infinity }
}
}
]
)
Résultat :
{ "result" : Infinity }
Cependant, -Infinity
renverra une erreur.
Champs inexistants
Si le $acosh
l'opérateur est appliqué sur un champ qui n'existe pas, null
est renvoyé.
Exemple :
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: "$wrongField" }
}
}
]
)
Résultat :
{ "result" : null }