$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 toma un documento con los siguientes $ltrim campos:

Campo	Descripción
input	La string que se va a recortar. El argumento puede ser cualquier expresión válida que se resuelva en una string. Para más información sobre expresiones, consulte 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 cadena. El operador divide $ltrim la cadena en puntos de código UTF individuales para recortar input de. Si no se especifica, elimina los caracteres de espacio en blanco, incluido el carácter nulo. Para ver la lista de caracteres de espacio en blanco, consulte Caracteres $ltrimde espacio en blanco.

Tip

• $trim

• $rtrim

Comportamiento

• Por defecto, elimina los caracteres de espacio en blanco, incluido el carácter nulo, del principio de la cadena de$ltrim entrada:

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

• Puedes sobrescribir los caracteres por defecto para recortar usando 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 se cambian los caracteres por defecto para recortar, se puede incluir explícitamente el (los) carácter(es) de espacio en blanco que se deben recortar en el campo chars.

  Por ejemplo, lo siguiente elimina cualquier espacio, g o d del inicio de la string de entrada.

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

Limitaciones

A partir de MongoDB 8.0.22, la longitud de la string que se proporciona a chars está limitada a 4096 caracteres. Si proporcionas una string más larga de 4096 caracteres, MongoDB devolverá un error similar al siguiente:

$trim/$ltrim/$rtrim requires 'chars' to be not greater than 4096 bytes, got
<length> bytes instead.

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 $ltrim en description blanco iniciales del 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 }