$toLower(集計)
定義
$toLower
文字列を小文字に変換し、結果を返します。
$toLower
の構文は次のとおりです。{ $toLower: <expression> } 引数は、string に変換される限り、任意の式にすることができます。 式の詳細については、「式演算子 」を参照してください。
引数が null に解決された場合、
$toLower
は空のstring""
を返します。
動作
$toLower
は ASCII 文字の文字列に対してのみ、明確に定義された動作を行います。
例
以下のドキュメントを持つinventory
コレクションを考えてみましょう。
db.inventory.insertMany( [ { "_id" : 1, "item" : "ABC1", quarter: "13Q1", "description" : "PRODUCT 1" }, { "_id" : 2, "item" : "abc2", quarter: "13Q4", "description" : "Product 2" }, { "_id" : 3, "item" : "xyz1", quarter: "14Q2", "description" : null } ] )
次の操作では、$toLower
オペレーターを使用して小文字の item
と小文字の description
の値を返します。
db.inventory.aggregate( [ { $project: { item: { $toLower: "$item" }, description: { $toLower: "$description" } } } ] )
この操作は次の結果を返します。
{ "_id" : 1, "item" : "abc1", "description" : "product 1" } { "_id" : 2, "item" : "abc2", "description" : "product 2" } { "_id" : 3, "item" : "xyz1", "description" : "" }