BinData()（mongoshメソッド）

定義

バイナリ・データ・オブジェクトを作成します。

BinData の構文は次のとおりです。

BinData(<sub_type>,<buffer>)

Parameter	タイプ	説明
sub_type	integer	バイナリ サブタイプ
buffer	string	バイナリ データを含むバッファ オブジェクト。 基本64でエンコードされたstring値である必要があります。

次の値を返します。	バイナリ データ オブジェクト。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

システムのエンディアン性は、マシンのアーキテクチャによって異なります。 BSON データ内の数値は常にリトルエンディアンとして保存されます。システムがビッグエンディアンの場合、数値データはビッグエンディアンとリトルエンディアンの間で変換されます。

ビットテスト マッチ式演算子のコンテキストでは、次のようになります。

• $bitsAnySet

• $bitsAnyClear

• $bitsAllSet

• $bitsAllClear

BinData 値はビットマスクとして機能し、任意の長さの符号のないリトルエンディアン数であるかのように解釈されます。アドレス指定可能な最小バイトは、常に最下位バイトとして解釈されます。同様に、BinData 内の最上位バイトは、常に最上位バイトとして解釈されます。

例

var bdata = BinData(0, "gf1UcxdHTJ2HQ/EGQrO7mQ==")

db.testbin.insertOne( { _id : 1, bin_data: bdata } )

db.testbin.find()

{
  _id: 1,
  bin_data: Binary(Buffer.from("81fd547317474c9d8743f10642b3bb99", "hex"), 0)
}

var bdata = BinData(0, "gf1UcxdHTJ2HQ/EGQrO7mQ==")

bdata.length()

16