No MongoDB, o
$asin
operador de pipeline de agregação retorna o arcsine (seno inverso) de um valor, medido em radianos. $asin
aceita qualquer expressão válida que resolva um número entre -1
e 1
. O
$asin
O operador foi introduzido no MongoDB 4.2. Exemplo
Suponha que tenhamos uma coleção chamada
test
com o seguinte documento:{ "_id" : 1, "data" : 0.5 }
Podemos usar o
$asin
operador para retornar o arco-seno do data
campo:db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
{ "arcsine" : 0.5235987755982988 }
Por padrão, o
$asin
operador retorna valores como um double
, mas também pode retornar valores como um decimal de 128 bits, desde que a expressão resolva para um valor decimal de 128 bits. Converter em graus
Como mencionado,
$asin
retorna seu resultado em radianos. Você pode usar o $radiansToDegrees
operador se você quiser o resultado em graus. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
radians: { $asin: "$data" },
degrees: { $radiansToDegrees: { $asin: "$data" } }
}
}
]
)
Resultado:
{ "radians" : 0.5235987755982988, "degrees" : 29.999999999999996 }
Neste exemplo, o primeiro campo apresenta o resultado em radianos e o segundo campo o apresenta em graus.
Valores decimais de 128 bits
Se a expressão fornecida para
$asin
for decimal de 128 bits, o resultado será retornado em decimal de 128 bits. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 2, "data" : NumberDecimal("0.1301023541559787031443874490659") }
Vamos executar o
$asin
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
{ "arcsine" : NumberDecimal("0.1304722105697547116336288178856500") }
A saída é decimal de 128 bits.
Valores nulos
Valores nulos retornam
null
ao usar o $asin
operador. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 3, "data" : null }
Vamos executar o
$asin
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
{ "arcsine" : null }
Podemos ver que o resultado é
null
. Valores NaN
Se o argumento for resolvido para
NaN
, $asin
retorna NaN
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
arcsine: { $asin: 1 * "String" }
}
}
]
)
Resultado:
{ "arcsine" : NaN }
Nesse caso, a expressão tentou multiplicar um número por uma string, o que resultou em
NaN
sendo devolvido. Infinito
Se o argumento resolver para
Infinity
ou -Infinity
, o $asin
operador retorna um erro. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 4, "data" : Infinity }
Vamos executar
$asin
contra o campo de dados:db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $asin to inf, value must in [-1,1]", "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
Esse é o erro que recebo no
mongo
shell ao executar esse código. Campos inexistentes
Se o
$asin
operador é aplicado em um campo que não existe, null
é devolvido. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$wrong" }
}
}
]
)
Resultado:
{ "arcsine" : null }
Valores fora do intervalo
Fornecendo um valor fora do intervalo para
$asin
resultará em erro. Já vimos o que acontece quando fornecemos Infinity
para $asin
. Agora vamos usar um valor mais realista, como, digamos, 2
. Suponha que adicionamos o seguinte documento à coleção:
{ "_id" : 5, "data" : 2 }
Agora vamos executar
$asin
contra os data
campo:db.test.aggregate(
[
{ $match: { _id: 5 } },
{ $project: {
_id: 0,
arcsine: { $asin: "$data" }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $asin to 2, value must in [-1,1]", "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
Como a mensagem de erro indica, o valor deve estar entre
-1
e 1
.