$trim (operador de expresión)

Definición

$trim

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

$trim tiene la siguiente sintaxis:

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

El $trim 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(los) carácter(es) a recortar de input. El argumento puede ser cualquier expresión válida que se resuelva en una string. El operador $trim divide la cadena en puntos de códigoUTF individuales.para recortar input desde. Si no se especifica, $trim remueve los caracteres de espacio en blanco, incluido el carácter nulo. Para la lista de caracteres de espacio, consulta Caracteres de espacio.

Tip

• $ltrim

• $rtrim

Comportamiento

• Por defecto, $trim elimina los caracteres de espacio en blanco, incluido el carácter nulo:

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

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

  Por ejemplo, lo siguiente elimina cualquier g y e del inicio y final de la entrada. Dado que la entrada comienza con un espacio en blanco, ningún carácter puede ser eliminado del inicio de la string.

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

• 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, e del inicio y del final de la entrada.

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

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 $trim para remover los espacios en blanco al principio y al final del campo description:

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

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