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

$rtrim (agregação)

Nesta página

  • Definição
  • Comportamento
  • Exemplo
$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:

Campo
Descrição
input
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 de input.

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.

Dica

Veja também:

  • $ltrim

  • $trim

  • Por padrão, $rtrim remove o espaço em branco, incluindo o caractere nulo, do final da string de entrada:

    Exemplo
    Resultados
    { $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 e e 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.

    Exemplo
    Resultados
    { $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.

    Exemplo
    Resultados
    { $rtrim: { input: " ggggoodbyeeeee ", chars: "e " } }
    " ggggoodby"

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

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 }

Voltar

$round