MongoDB, o
$strLenCP
operador de pipeline de agregação retorna o número de pontos de código UTF-8 na string especificada. O
$strLenCP
operador é diferente do $strLenBytes
operador, que retorna o número de bytes na string. Exemplo
Suponha que tenhamos uma coleção chamada
english
com os seguintes documentos:{ "_id" :1, "data" :"Maimuang" }{ "_id" :2, "data" :"M" }{ "_id" :3, "data" :"a" }{ " _id" :4, "data" :"i" }{ "_id" :5, "data" :"m" }{ "_id" :6, "data" :"u" }{ "_id" :7, "data" :"a" }{ "_id" :8, "data" :"n" }{ "_id" :9, "data" :"g" }
Podemos aplicar
$strLenCP
para o campo de dados nesses documentos:db.english.aggregate(
[
{
$project:
{
_id: 0,
data: 1,
result: { $strLenCP: "$data" }
}
}
]
)
Resultado:
{ "dados" :"Maimuang", "resultado" :8 }{ "dados" :"M", "resultado" :1 }{ "dados" :"a", "resultado" :1 }{ " data" :"i", "resultado" :1 }{ "dados" :"m", "resultado" :1 }{ "dados" :"u", "resultado" :1 }{ "dados" :"a ", "resultado" :1 }{ "dados" :"n", "resultado" :1 }{ "dados" :"g", "resultado" :1 }
Podemos ver que a palavra inteira usa 8 pontos de código e cada caractere usa um ponto de código.
Personagens tailandeses
Aqui está um exemplo que usa caracteres tailandeses, que são 3 bytes cada, mas usam apenas um ponto de código.
Temos uma coleção chamada
thai
com os seguintes documentos:{ "_id" :1, "data" :"ไม้เมือง" }{ "_id" :2, "data" :"ไ" }{ "_id" :3, "data" :"ม้" }{ "_id" :4, "data" :"เ" }{ "_id" :5, "data" :"มื" }{ "_id" :6, "data" :"อ" }{ "_id" :7 , "dados" :"ง" }
E aqui está o que acontece quando aplicamos
$strLenCP
a esses documentos:db.thai.aggregate( [ { $project:{ _id:0, data:1, result:{ $strLenCP:"$data" } } } ])
Resultado:
{ "dados" :"ไม้เมือง", "resultado" :8 }{ "dados" :"ไ", "resultado" :1 }{ "dados" :"ม้", "resultado" :2 }{ "data" :"เ", "resultado" :1 }{ "dados" :"มื", "resultado" :2 }{ "dados" :"อ", "resultado" :1 }{ "dados" :" ง", "resultado" :1 }
Dois desses caracteres foram modificados usando diacríticos, o que resulta no retorno de 2 pontos de código. Esses caracteres retornam 6 bytes ao usar o
$strLenBytes
operador. Outros personagens
Suponha que tenhamos uma coleção chamada
other
com os seguintes documentos:{ "_id" :1, "data" :"é" }{ "_id" :2, "data" :"©" }{ "_id" :3, "data" :"℘" }
E vamos aplicar$strLenCP
a esses documentos:
db.other.aggregate( [ { $match: { _id: { $in: [ 1, 2, 3 ] } } }, { $project: { _id: 0, data: 1, result: { $strLenCP: "$data" } } } ] )
Resultado:
{ "dados" :"é", "resultado" :1 }{ "dados" :"©", "resultado" :1 }{ "dados" :"℘", "resultado" :1 }
Cada um desses caracteres usa um único ponto de código (mesmo que esses caracteres usem mais de um byte).
O caractere de espaço usa um ponto de código. Dois caracteres de espaço, portanto, usam 2 pontos de código e assim por diante.
Suponha que temos os seguintes documentos:
{ "_id" :4, "data" :" " }{ "_id" :5, "data" :" " }
E aplicamos$strLenCP
a esses documentos:
db.other.aggregate( [ { $match: { _id: { $in: [ 4, 5 ] } } }, { $project: { _id: 0, data: 1, result: { $strLenCP: "$data" } } } ] )
Resultado:
{ "dados" :" ", "resultado" :1 }{ "dados" :" ", "resultado" :2 }Strings vazias
Strings vazias retornam0
.
Aqui está um documento com uma string vazia:
{ "_id" :6, "data" :"" }
E aqui está o que acontece quando aplicamos$strLenCP
a esse documento:
db.other.aggregate( [ { $match: { _id: { $in: [ 6 ] } } }, { $project: { _id: 0, data: 1, result: { $strLenCP: "$data" } } } ] )
Resultado:
{ "dados" :"", "resultado" :0 }Tipo de dados incorreto
Passar o tipo de dados errado resulta em um erro.
Suponha que temos o seguinte documento:
{ "_id" :7, "dados" :123 }
Ofield
de dados contém um número.
Vamos aplicar$strLenCP
a esse documento:
db.other.aggregate( [ { $match: { _id: { $in: [ 7 ] } } }, { $project: { _id: 0, data: 1, result: { $strLenCP: "$data" } } } ] )
Resultado:
exceção não capturada:Erro:comando falhou:{ "ok":0, "errmsg":"$strLenCP requer um argumento de string, encontrado:double", "code":34471, "codeName":"Location34471"}:falha na agregação :[email protected]/mongo/shell/utils.js:25:[email protected]/mongo/shell/assert.js:18:[email protected]/mongo/shell/assert.js:639 :[email protected]/mongo/shell/assert.js:729:[email protected]/mongo/shell/db.js:266:[email protected]/mongo/shell/collection.js:1058:12 @(shell):1:1Valores nulos
Fornecendonull
também resulta em erro.
Suponha que temos o seguinte documento:
{ "_id":8, "data":null }
Ofield
de dados contémnull
.
Vamos aplicar$strLenCP
a esse documento:
db.other.aggregate( [ { $match: { _id: { $in: [ 8 ] } } }, { $project: { _id: 0, data: 1, result: { $strLenCP: "$data" } } } ] )
Resultado:
Erro:comando falhou:{ "ok":0, "errmsg":"$strLenCP requer um argumento de string, encontrado:null", "code":34471, "codeName":"Location34471"}:agregado falhou:[email protected]/mongo/shell/utils.js:25:[email protected]/mongo/shell/assert.js:18:[email protected]/mongo/shell/assert.js:639:17example@ sqldat.com/mongo/shell/assert.js:729:[email protected]/mongo/shell/db.js:266:[email protected]/mongo/shell/collection.js:1058:12@(shell ):1:1Campos ausentes
Continuando com o tema de produzir erros, especificar um campo inexistente também produz um erro.
Documento:
{ "_id":9 }
Aplicar$strLenCP
:
db.other.aggregate( [ { $match: { _id: { $in: [ 9 ] } } }, { $project: { _id: 0, data: 1, result: { $strLenCP: "$data" } } } ] )
Resultado:
Erro:comando falhou:{ "ok":0, "errmsg":"$strLenCP requer um argumento de string, encontrado:ausente", "code":34471, "codeName":"Location34471"}:agregado falhou:[email protected]/mongo/shell/utils.js:25:[email protected]/mongo/shell/assert.js:18:[email protected]/mongo/shell/assert.js:639:17example@ sqldat.com/mongo/shell/assert.js:729:[email protected]/mongo/shell/db.js:266:[email protected]/mongo/shell/collection.js:1058:12@(shell ):1:1