$rtrim (operador de expresión)

Definición

$rtrim

Elimina los caracteres de espacio en blanco, incluido el nulo, o los caracteres especificados del final de una string.

$rtrim tiene la siguiente sintaxis:

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

El $rtrim 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. Los caracteres que se eliminarán al final del input. El argumento puede ser cualquier expresión válida que se resuelva en una string. El operador $rtrim divide la cadena en puntos de códigoUTF individuales. para recortar de input. Si no se especifica, $rtrim 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

• $trim

Comportamiento

• Por defecto, $rtrim elimina el espacio en blanco, incluido el carácter nulo, del final de la string de entrada:

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

• Puedes sobrescribir los caracteres por defecto para recortar usando el campo chars.

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

  Ejemplo	Resultados
  { $rtrim: { 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, el siguiente recorta cualquier espacio o e del final de la string de entrada.

  Ejemplo	Resultados
  { $rtrim: { input: " ggggoodbyeeeee ", chars: "e " } }	" ggggoodby"

Limitaciones

A partir de MongoDB 8.3, la longitud de la string que proporciones a chars está limitada a 4096 caracteres. Si proporcionas una string más larga que 4096 caracteres, MongoDB devuelve 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 $rtrim para remover los espacios en blanco finales del campo description:

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