Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

$strLenCP (agregação)

Nesta página

  • Definição
  • Comportamento
  • Exemplo
$strLenCP

Retorna o número depontos de código UTF-8 na string especificada.

$strLenCP tem a seguintesintaxe de expressão do operador :

{ $strLenCP: <string expression> }

O argumento pode ser qualquer expressão válida que resolva para uma string.

Se o argumento for resolvido para um valor de null ou se referir a um campo ausente, $strLenCP retornará um erro.

Exemplo
Resultados
{ $strLenCP: "abcde" }
5
{ $strLenCP: "Hello World!" }
12
{ $strLenCP: "cafeteria" }
9
{ $strLenCP: "cafétéria" }
9
{ $strLenCP: "" }
0
{ $strLenCP: "$€λA" }
4
{ $strLenCP: "寿司" }
2

O operador $strLenCP conta o número de pontos de código na string especificada. Este comportamento difere do operador $strLenBytes que conta o número de bytes na string, onde cada caractere usa entre um e quatro bytes.

Crie uma coleção food:

db.food.insertMany( [
{ _id: 1, name: "apple" },
{ _id: 2, name: "banana" },
{ _id: 3, name: "éclair" },
{ _id: 4, name: "hamburger" },
{ _id: 5, name: "jalapeño" },
{ _id: 6, name: "pizza" },
{ _id: 7, name: "tacos" },
{ _id: 8, name: "寿司" }
] )

O exemplo seguinte utiliza o operador $strLenCP para calcular length de cada valor name:

db.food.aggregate( [
{
$project: {
name: 1,
length: { $strLenCP: "$name" }
}
}
] )

Saída de exemplo:

[
{ _id: 1, name: 'apple', length: 5 },
{ _id: 2, name: 'banana', length: 6 },
{ _id: 3, name: 'éclair', length: 6 },
{ _id: 4, name: 'hamburger', length: 9 },
{ _id: 5, name: 'jalapeño', length: 8 },
{ _id: 6, name: 'pizza', length: 5 },
{ _id: 7, name: 'tacos', length: 5 },
{ _id: 8, name: '寿司', length: 2 }
]

Dica

Veja também:

Voltar

$strLenBytes