$ltrim（集計）

定義

$ltrim

string の先頭から、null を含む空白文字または指定した文字を除きます。

$ltrim の構文は次のとおりです。

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

$ltrimは、次のフィールドを持つドキュメントを取得します。

フィールド	説明
input	削除する string。 引数は、string に変換されるなら、どのような有効な式でも使用できます。 式の詳細については、「式演算子 」を参照してください。
chars	任意。 inputの先頭から削除する文字。 引数は、string に変換されるなら、どのような有効な式でも使用できます。 $ltrim演算子は string を個々の UTF コード ポイント inputに分割します。 は から削除されます。 指定されていない場合、 $ltrim では null 文字を含む空白文字が除かれます。空白文字のリストについては、「空白文字」を参照してください。

Tip

以下も参照してください。

• $trim

• $rtrim

動作

• デフォルトでは、 $ltrimにより、入力 string の先頭から null 文字を含む空白文字が削除されます。

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

• chars フィールドを使用して、削除するデフォルトの文字を上書きできます。

  たとえば、次の例では、入力stringの先頭から任意の g と e を削除します。 入力は空白で始まるので、どちらの文字も string の先頭から削除することはできません。

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

• 削除するデフォルトの文字をオーバーライドする場合は、削除する空白文字を chars フィールドに明示的に含めることができます。

  たとえば、次の例では、入力stringの先頭から任意のスペース（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 }