$rtrim（聚合）

定义

$rtrim

删除字符串末尾的空白字符（包括 null）或指定字符。

$rtrim 通过以下语法实现：

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

$rtrim 接受包含以下字段的文档：

字段	说明
input	要修剪的string 。 该参数可以是任何解析为 的有效 表达式 string。有关表达式的更多信息，请参阅表达式操作符。
chars	可选。 要从input末尾修剪的字符。 该参数可以是任何解析为 的有效 表达式 string。操作符将 $rtrim分解为单个string UTF 代码点 从 修剪。input 如果未指定，$rtrim 会删除空白字符，包括 null 字符。有关空白字符列表，请参阅空白字符。

提示

另请参阅：

• $ltrim

• $trim

行为

• 默认情况下， $rtrim会删除输入string末尾的空格，包括空字符：

  例子	结果
  { $rtrim: { input: " \n good bye \t " } }	" \n good bye"

• 可使用 chars 字段覆盖待修剪的默认字符。

  例如，以下代码会删除输入字符串末尾的所有g和e 。 由于输入以空格结尾，因此无法从字符串末尾修剪这两个字符。

  例子	结果
  { $rtrim: { input: "ggggoodbyeeeee ", chars: "ge" } }	"ggggoodbyeeeee "

• 如果覆盖待修剪的默认字符，则可以在 chars 字段中明确包含待修剪的空白字符。

  例如，以下代码会删除输入字符串末尾的所有空格或e 。

  例子	结果
  { $rtrim: { input: " ggggoodbyeeeee ", chars: "e " } }	" ggggoodby"

例子

考虑包含以下文档的 inventory 集合：

{ "_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 }

以下操作使用$rtrim操作符删除description字段中的尾随空格：

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

操作返回以下结果：

{ "_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 }