$strLenCP（集計）

項目一覧

定義

動作
例

定義

$strLenCP

バージョン 3.4 で追加。

UTF-8 コードポイントの数を返します指定された string 内の。

$strLenCPには次の演算子式の構文があります。

{ $strLenCP: <string expression> }

引数は、文字列に変換されるなら、どのような有効な式でも使用できます。

引数が null 値に解決されるか、欠落しているフィールドを参照する場合、$strLenCP はエラーを返します。

例	結果
`{ $strLenCP: "abcde" }`	`5`
`{ $strLenCP: "Hello World!" }`	`12`
`{ $strLenCP: "cafeteria" }`	`9`
`{ $strLenCP: "cafétéria" }`	`9`
`{ $strLenCP: "" }`	`0`
`{ $strLenCP: "$€λA" }`	`4`
`{ $strLenCP: "寿司" }`	`2`

動作

$strLenCP演算子は、指定された string 内のコードポイントの数をカウントします。この動作は、string 内のバイト数をカウントする$strLenBytes演算子とは異なります。ここでは、各文字は 1 から 4 バイトの間を使用します。

例

シングルバイトおよびマルチバイト文字セット

food コレクションを作成します。

db.food.insertMany( [
   { _id: 1, name: "apple" },
   { _id: 2, name: "banana" },
   { _id: 3, name: "éclair" },
   { _id: 4, name: "hamburger" },
   { _id: 5, name: "jalapeño" },
   { _id: 6, name: "pizza" },
   { _id: 7, name: "tacos" },
   { _id: 8, name: "寿司" }
] )

次の例では、$strLenCP 演算子を使用して、各 name 値の length を計算します。

db.food.aggregate( [
   {
      $project: {
         name: 1,
         length: { $strLenCP: "$name" }
      }
   }
] )

出力例:

[
   { _id: 1, name: 'apple', length: 5 },
   { _id: 2, name: 'banana', length: 6 },
   { _id: 3, name: 'éclair', length: 6 },
   { _id: 4, name: 'hamburger', length: 9 },
   { _id: 5, name: 'jalapeño', length: 8 },
   { _id: 6, name: 'pizza', length: 5 },
   { _id: 7, name: 'tacos', length: 5 },
   { _id: 8, name: '寿司', length: 2 }
]

Tip

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

$strLenBytes

戻る

$strLenBytes

$substr