$ltrim (operador de expresión)

Definición

$ltrim

Elimina los caracteres de espacio, incluido el nulo, o los caracteres especificados del principio de una string.

$ltrim tiene la siguiente sintaxis:

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

El $ltrim procesa un documento con los siguientes campos:

Campo	Descripción
input	La string a recortar. El argumento puede ser cualquier valor válido expresión que se resuelve en una string. Para obtener más información sobre las expresiones, consulta Expresiones.
chars	opcional. El carácter o los caracteres que se deben recortar del principio de input. El argumento puede ser cualquier expresión válida que se resuelva en una string. El operador $ltrim divide la cadena en puntos de códigoUTF individuales.para recortar input desde. Si no se especifica, $ltrim remueve los caracteres de espacio en blanco, incluido el carácter nulo. Para la lista de caracteres de espacio, consulta Caracteres de espacio.

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 elimina cualquier g y e desde el comienzo de la string de entrada. Puesto que la entrada comienza con un espacio en blanco, no se puede recortar ninguno de los caracteres desde el inicio de la string.

  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 usa el operador $ltrim para remover los espacios en blanco iniciales del campo description:

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 }