No MongoDB, o
$log10
operador de pipeline de agregação calcula a base de log 10 de um número e retorna o resultado como um duplo. $log10
aceita qualquer expressão válida que resolva para um número não negativo. O
$log10
O operador foi introduzido no MongoDB 3.2. Exemplo
Suponha que tenhamos uma coleção chamada
test
com o seguinte documento:{ "_id" : 1, "data" : 0.5 }
Podemos usar o
$log10
operador para retornar a base de log 10 dos data
campo:db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $log10: "$data" }
}
}
]
)
Resultado:
{ "result" : -0.3010299956639812 }
Valores fora do intervalo
Como mencionado, o
$log10
O operador aceita qualquer expressão válida que resolva para um número não negativo. Valores fora desse intervalo causarão um erro. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 2, "data" : -3 }
Vamos executar o
$log10
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
result: { $log10: "$data" }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "$log10's argument must be a positive number, but is -3", "code" : 28761, "codeName" : "Location28761" } : 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
Valores nulos
Valores nulos retornam
null
ao usar o $log10
operador. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 3, "data" : null }
Vamos executar o
$log10
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
result: { $log10: "$data" }
}
}
]
)
Resultado:
{ "result" : null }
Podemos ver que o resultado é
null
. Valores NaN
Se o argumento resolver para
NaN
, $log10
retorna NaN
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $log10: 1 * "$data" }
}
}
]
)
Resultado:
{ "result" : NaN }
Campos inexistentes
Se o
$log10
operador é aplicado em um campo que não existe, null
é devolvido. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
result: { $log10: "$name" }
}
}
]
)
Resultado:
{ "result" : null }