/ /

$toBool（式）

定義

$toBool

値をブール値に変換します。

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

{
   $toBool: <expression>
}

The $toBool takes any valid expression.

The $toBool is a shorthand for the following $convert expression:

{ $convert: { input: <expression>, to: "bool" } }

Tip

$convert

動作

次の表でブール値に変換できる入力型を一覧にしています。

入力タイプ	動作
配列	true を返します
バイナリデータ	true を返します
ブール値	何も起こりません。ブール値を返します。
コード	true を返します
日付	true を返します
小数点	0 でない場合、`true` を返します。 0 の場合、`false` を返します。
Double	0 でない場合、`true` を返します。 0 の場合、`false` を返します。
整数	0 でない場合、`true` を返します。 0 の場合、`false` を返します。
JavaScript	true を返します
Long	0 でない場合、`true` を返します。 0 の場合、`false` を返します。
Max key	true を返します
MinKey	true を返します
null	値が null を返します
オブジェクト	true を返します
ObjectId	true を返します
正規表現	true を返します
文字列	true を返します
タイムスタンプ	true を返します

MongoDB のデータ型の詳細については、「BSON types」をご覧ください。

次の表でブール値への変換例を一覧にしています。

例	結果
`{$toBool: false}`	false
`{$toBool: 1.99999}`	true
`{$toBool: Decimal128("5")}`	true
`{$toBool: Decimal128("0")}`	false
`{$toBool: 100}`	true
`{$toBool: ISODate("2018-03-26T04:38:28.044Z")}`	true
`{$toBool: "false"}`	true
`{$toBool: ""}`	true
`{$toBool: null}`	null

例

次のドキュメントを使用してコレクション orders を作成します。

db.orders.insertMany( [
   { _id: 1, item: "apple",  qty: 5, shipped: true },
   { _id: 2, item: "pie",  qty: 10, shipped: 0  },
   { _id: 3, item: "ice cream", shipped: 1 },
   { _id: 4, item: "almonds", qty: 2, shipped: "true" },
   { _id: 5, item: "pecans", shipped: "false" },  // Note: All strings convert to true
   { _id: 6, item: "nougat", shipped: ""  }       // Note: All strings convert to true
] )

ordersコレクションに対する次の集計操作では、未払いの注文を検索する前にshippedをブール値に変換します。

// Define stage to add convertedShippedFlag field with the converted shipped value
// Because all strings convert to true, include specific handling for "false" and ""
shippedConversionStage = {
   $addFields: {
      convertedShippedFlag: {
         $switch: {
            branches: [
              { case: { $eq: [ "$shipped", "false" ] }, then: false } ,
              { case: { $eq: [ "$shipped", "" ] }, then: false }
            ],
            default: { $toBool: "$shipped" }
        }
      }
   }
};
// Define stage to filter documents and pass only the unshipped orders
unshippedMatchStage = {
   $match: { "convertedShippedFlag": false }
};
db.orders.aggregate( [
  shippedConversionStage,
  unshippedMatchStage
] )

この操作を実行すると次のドキュメントが返されます。

{ "_id" : 2, "item" : "pie", "qty" : 10, "shipped" : 0, "convertedShippedFlag" : false }
{ "_id" : 5, "item" : "pecans", "shipped" : "false", "convertedShippedFlag" : false }
{ "_id" : 6, "item" : "nougat", "shipped" : "", "convertedShippedFlag" : false }

注意

変換操作でエラーが発生した場合、集計操作は停止し、エラーがスローされます。この動作をオーバーライドするには、代わりに $convert を使用します。

戻る

$toArray

$toDate