$trim (agregação)

Definição

$trim

Remove caracteres de espaço em branco, incluindo nulos, ou os caracteres especificados do início e do fim de uma string.

$trim tem a seguinte sintaxe:

{ $trim: { input: <string>,  chars: <string> } }

O $trim 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 de input. O argumento pode ser qualquer expressão válida que produza uma string. O operador $trim divide a cadeia de caracteres em ponto código UTF individual código para cortar input. Se não for especificado, remove os caracteres de espaço em branco, inclusive o caractere$trim nulo. Para obter a lista de caracteres de espaço em branco, consulte Caracteres de espaço em branco.

Dica

• $ltrim

• $rtrim

Comportamento

• Por padrão, $trim remove caracteres de espaço em branco, incluindo o caractere nulo:

  Exemplo	Resultados
  { $trim: { input: " \n good bye \t " } }	"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 início e do final da entrada. Uma vez que a entrada começa com um espaço em branco, nenhum dos caracteres pode ser cortado a partir do início da string.

  Exemplo	Resultados
  { $trim: { input: " ggggoodbyeeeee", chars: "ge" } }	" ggggoodby"

• 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, g, e do início e do final da entrada.

  Exemplo	Resultados
  { $trim: { input: " ggggoodbyeeeee", chars: " ge" } }	"oodby"

Exemplo

Considere uma coleção inventory com os seguintes documentos:

db.inventory.insertMany( [
   { _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 operação a seguir usa o operador $trim para remover os espaços em branco à esquerda e à direita do campo description:

db.inventory.aggregate([
   { $project: { item: 1, description: { $trim: { input: "$description" } } } }
])

A operação retorna os seguintes resultados:

{ _id: 1, item: "ABC1", description: "product 1" }
{ _id: 3, item: "XYZ1", description: null }
{ _id: 2, item: "ABC2", description: "product 2 \n The product is in stock." }