$ltrim (aggregation)

Definição

$ltrim

Removes whitespace characters, including null, or the specified characters from the beginning of a string.

$ltrim tem a seguinte sintaxe:

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

O $ltrim pega um documento com os seguintes campos:

Campo	Descrição
input	A string a ser cortada. O argumento pode ser qualquer expressão válida que produza uma string. Para mais informações sobre expressões, consulte Operadores de Expressão.
chars	Optional. The character(s) to trim from the beginning of the input. O argumento pode ser qualquer expressão válida que produza uma string. O operador divide a $ltrim cadeia de caracteres em ponto código UTF individual para input cortar. Se não for especificado, remove os caracteres de espaço em branco, inclusive o caractere$ltrim nulo. Para obter a lista de caracteres de espaço em branco, consulte Caracteres de espaço em branco.

Dica

Veja também:

• $trim

• $rtrim

Comportamento

• By default, $ltrim removes whitespace characters, including the null character, from the beginning of the input string:

  Exemplo	Resultados
  { $ltrim: { input: " \n good bye \t " } }	"good bye \t "

• Você pode substituir os caracteres padrão para cortar usando o campo chars.

  For example, the following trims any g and e from the start of the input string. Since the input starts with a whitespace, neither character can be trimmed from the start of the string.

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

  For example, the following trims any space, g, or d from the start of the input string.

  Exemplo	Resultados
  { $ltrim: { input: " ggggoodbyeeeee ", chars: " gd" } }	"oodbyeeeee "

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 }

The following operation uses the $ltrim operator to remove leading whitespaces from the description field:

db.inventory.aggregate([
   { $project: { item: 1, description: { $ltrim: { 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.  \n\n  " }
{ "_id" : 3, "item" : "XYZ1", "description" : null }