$ltrim (operador de expresión)

Definición

$ltrim

Elimina los caracteres de espacio en blanco, incluidos los nulos, o los caracteres especificados del comienzo de una cadena.

$ltrim tiene la siguiente sintaxis:

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

El $ltrim procesa un documento con los siguientes campos:

Campo	Descripción
input	La cadena que se va a recortar. El argumento puede ser cualquier valor válido. Expresión que se resuelve en una cadena. Para más información sobre expresiones, consulte Expresiones.
chars	Opcional. El/los carácter(es) a recortar del comienzo de input. El argumento puede ser cualquier expresión válida que se resuelva en una cadena. El $ltrim operador descompone la cadena en puntos de código UTF individuales.para recortar input desde. Si no se especifica, elimina los espacios en blanco, incluido el carácter nulo. Para ver la lista de espacios en blanco, consulte$ltrim Caracteres de espacio en blanco.

Tip

• $trim

• $rtrim

Comportamiento

• De forma predeterminada, elimina los caracteres de espacio en blanco, incluido el carácter nulo, del comienzo de la cadena de$ltrim entrada:

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

• Puede anular los caracteres predeterminados para recortar utilizando el campo chars.

  Por ejemplo, lo siguiente recorta cualquier g y e del inicio de la cadena de entrada. Dado que la entrada empieza con un espacio, no se puede recortar ningún carácter del inicio de la cadena.

  Ejemplo	Resultados
  { $ltrim: { input: " ggggoodbyeeeee", chars: "ge" } }	" ggggoodbyeeeee"

• Si desea anular los caracteres predeterminados para recortar, puede incluir explícitamente los caracteres de espacio en blanco para recortar en el campo chars.

  Por ejemplo, lo siguiente recorta cualquier espacio, g o d desde el comienzo de la cadena de entrada.

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

Ejemplo

Considere una colección inventory con los siguientes 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 },
] )

La siguiente operación utiliza el operador para eliminar los espacios iniciales $ltrim del description campo:

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

La operación devuelve los siguientes 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 }