BinData()

項目一覧

定義

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

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

BinData(<sub_type>,<buffer>)

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

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

sub_typeには次のいずれかの値を指定します。

番号	説明
0	汎用バイナリのサブタイプ
1	関数データ
2	バイナリ（旧）
3	UUID（旧）
4	UUID
5	MD5
6	暗号化された BSON 値
7	圧縮された時系列データバージョン 5.2 で追加。
8	キーやシークレットなどの機密データ。 MongoDB では、サブタイプ 8 のバイナリデータのリテラル値はログに記録されません。代わりに、MongoDB は`###`のプレースホルダー値をログに記録します。
9	ベクトルデータとは、同じ型の数値が高密度に圧縮された配列です。
128	カスタムデータ

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

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

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

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

BinData() コンストラクターを使って bdata 変数を作成します。

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

オブジェクトを testbin コレクションに挿入します。

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

挿入されたドキュメントの testbin コレクションをクエリします。

db.testbin.find()

コレクションに格納されたバイナリ buffer を見ることができます。

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

BinData() コンストラクターを使って bdata 変数を作成します。

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

.length() を使用して、オブジェクトのビット長を返します。

bdata.length()

戻り値は次のとおりです。

戻る

Binary.createFromHexString

BSONRegExp