$ltrim（聚合）

定义

$ltrim

删除字符串开头的空格字符（包括 null）或指定的字符。

$ltrim 通过以下语法实现：

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

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

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

提示

另请参阅：

• $trim

• $rtrim

行为

• 默认情况下，$ltrim 会从输入字符串的开头删除空格字符，包括 null 字符：

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

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

  例如，以下代码会从输入字符串的开头处删除任何 g 和 e。由于输入以空格开头，因此，不能从字符串的开头删除这两个字符。

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

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

  例如，以下代码会删除输入字符串开头处的任何空格、g 或 d。

  例子	结果
  { $ltrim: { input: " ggggoodbyeeeee ", chars: " gd" } }	"oodbyeeeee "

例子

考虑包含以下文档的 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 }

以下操作使用 $ltrim 操作符从 description 字段中删除前导空格：

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

操作返回以下结果：

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