In MongoDB is de $acosh
aggregatiepijplijnoperator retourneert de hyperbolische arccosinus (inverse hyperbolische cosinus) van een waarde, gemeten in radialen.
$acosh
accepteert elke geldige uitdrukking die wordt omgezet in een getal tussen 1
en +Infinity
.
De $acosh
operator werd geïntroduceerd in MongoDB 4.2.
Voorbeeld
Stel dat we een verzameling hebben met de naam test
met het volgende document:
{ "_id" : 1, "data" : 3 }
We kunnen de $acosh
. gebruiken operator om de hyperbolische arccosinus van de data
te retourneren veld:
db.test.aggregate(
[
{ $project: {
_id: 0,
hyperbolicArccosine: { $acosh: "$data" }
}
}
]
)
Resultaat:
{ "hyperbolicArccosine" : 1.762747174039086 }
Standaard is de $acosh
operator retourneert waarden als een double
, maar het kan ook waarden retourneren als een 128-bits decimaal, zolang de uitdrukking wordt omgezet in een 128-bits decimale waarde.
Omzetten naar graden
Zoals vermeld, $acosh
geeft het resultaat terug in radialen. U kunt de $radiansToDegrees
. gebruiken operator als u het resultaat in graden wilt.
Voorbeeld:
db.test.aggregate(
[
{ $project: {
_id: 0,
radians: { $acosh: "$data" },
degrees: { $radiansToDegrees: { $acosh: "$data" } }
}
}
]
)
Resultaat:
{ "radians" : 1.762747174039086, "degrees" : 100.99797342105244 }
In dit voorbeeld geeft het eerste veld het resultaat weer in radialen en het tweede veld geeft het weer in graden.
Waarden buiten bereik
Een waarde buiten het bereik opgeven aan $acosh
zal resulteren in een fout.
Stel dat we het volgende document aan de collectie toevoegen:
{ "_id" : 2, "data" : 0 }
Laten we nu $acosh
. uitvoeren tegen de data
veld:
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
radians: { $acosh: "$data" }
}
}
]
)
Resultaat:
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
Zoals de foutmelding aangeeft, moet de waarde tussen 1
. zijn en +Infinity
.
Null-waarden
Null-waarden retourneren null
bij gebruik van de $acosh
telefoniste.
Stel dat we het volgende document aan onze collectie toevoegen:
{ "_id" : 3, "data" : null }
Laten we de $acos
. uitvoeren operator tegen dat document:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: "$data" }
}
}
]
)
Resultaat:
{ "result" : null }
We kunnen zien dat het resultaat null
. is .
NaN-waarden
Als het argument wordt omgezet in NaN
, $acosh
retourneert NaN
.
Voorbeeld:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: 1 * "string" }
}
}
]
)
Resultaat:
{ "result" : NaN }
In dit geval probeerde ik een getal te vermenigvuldigen met een string, wat resulteerde in NaN
wordt geretourneerd.
Oneindig
Als het argument wordt omgezet in Infinity
, de $acosh
operator retourneert Infinity
.
Voorbeeld:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: Infinity }
}
}
]
)
Resultaat:
{ "result" : Infinity }
Echter, -Infinity
zal een fout retourneren.
Niet-bestaande velden
Als de $acosh
operator wordt toegepast op een veld dat niet bestaat, null
wordt geretourneerd.
Voorbeeld:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $acosh: "$wrongField" }
}
}
]
)
Resultaat:
{ "result" : null }