$rtrim (agregação)
Nesta página
Definição
$rtrim
Remove caracteres de espaço em branco, incluindo nulos, ou os caracteres especificados do final de uma string.
$rtrim
tem a seguinte sintaxe:{ $rtrim: { input: <string>, chars: <string> } } O
$rtrim
pega um documento com os seguintes campos:CampoDescriçãoinput
A string a ser cortada. O argumento pode ser qualquerexpressão válida que resolva para uma string. Para mais informações sobre expressões, consulte Expressões.chars
Opcional. Os caracteres a serem cortados do final do
input
.O argumento pode ser qualquer expressão válida que produza uma string. O operador divide a
$rtrim
de string caracteres em pontode código UTF individual para cortar deinput
.Se não for especificado,
$rtrim
remove os caracteres de espaço em branco, inclusive o caractere nulo. Para obter a lista de caracteres de espaço em branco, consulte Caracteres de espaço em branco.
Comportamento
Por padrão,
$rtrim
remove o espaço em branco, incluindo o caractere nulo, do final da string de entrada:ExemploResultados{ $rtrim: { input: " \n good bye \t " } }
" \n good bye"
Você pode substituir os caracteres padrão para cortar usando o campo
chars
.Por exemplo, o seguinte corta qualquer
g
ee
do final da string de entrada. Uma vez que a entrada termina com um espaço em branco, nenhum dos caracteres pode ser cortado a partir do final da string.ExemploResultados{ $rtrim: { input: "ggggoodbyeeeee ", chars: "ge" } }
"ggggoodbyeeeee "
Se substituir os caracteres padrão para cortar, você pode incluir explicitamente os caracteres de espaço em branco a serem cortados no campo
chars
.Por exemplo, o seguinte corta qualquer espaço ou
e
do final da string de entrada.ExemploResultados{ $rtrim: { input: " ggggoodbyeeeee ", chars: "e " } }
" ggggoodby"
Caracteres do espaço em branco
Por padrão, o $rtrim
remove o seguinte espaço em branco, incluindo o caractere nulo:
Unicode | Sequência de escape | Descrição |
---|---|---|
U+0000 | '0' | Caractere nulo |
U+0020 | ' ' | Espaço |
U+0009 | 't' | Aba horizontal |
U+000A | 'n' | Feed de linha/nova linha |
U+000B | 'v' | Aba vertical |
U+000C | 'f' | Feed de formulários |
U+000D | 'r' | Quebra de linha |
U+00A0 | Espaço ininterrupto | |
U+1680 | Marca de espaço Ogham | |
U+2000 | En quad | |
U+2001 | Em quad | |
U+2002 | En space | |
U+2003 | Em space | |
U+2004 | Three-per-em space | |
U+2005 | Four-per-em space | |
U+2006 | Six-per-em space | |
U+2007 | Espaço da figura | |
U+2008 | Espaço de pontuação | |
U+2009 | Espaço fino | |
U+200A | Espaço para o cabelo |
Exemplo
Considere uma coleção inventory
com os seguintes documentos:
{ "_id" : 1, "item" : "ABC1", quarter: "13Q1", "description" : " product 1" } { "_id" : 2, "item" : "ABC2", quarter: "13Q4", "description" : "product 2 \n The product is in stock. \n\n " } { "_id" : 3, "item" : "XYZ1", quarter: "14Q2", "description" : null }
A seguinte operação utiliza o operador $rtrim
para remover o espaço em branco à direita do campo description
:
db.inventory.aggregate([ { $project: { item: 1, description: { $rtrim: { input: "$description" } } } } ])
A operação retorna os seguintes resultados:
{ "_id" : 1, "item" : "ABC1", "description" : " product 1" } { "_id" : 2, "item" : "ABC2", "description" : "product 2 \n The product is in stock." } { "_id" : 3, "item" : "XYZ1", "description" : null }