オブジェクト ID

構成

• 4バイト : ビッグエンディアン形式の UNIX タイムスタンプ。

• 5バイト : ランダム数。

• 3バイト : ビッグエンディアンのrand()から増加する24ビットの単調なカウンター。

オブジェクト ID のソート

Cで並べ替える一般的な方法は、qsort() を使用することです。そのため、libson は bson_oid_compare という名前の qsort() 互換コールバック関数を提供します。2 つの bson_oid_t 構造の等価性に応じて、less than 1、greater than 1、または 0 が返されます。

オブジェクト ID の比較

2 つの bson_oid_t 構造の等価性を単純に比較する場合は、 bson_oid_equal を使用します。

生成

bson_id_t を生成するには、以下を使用できます。

bson_oid_t oid;
bson_oid_init (&oid, NULL);

ObjectId解析

bson_oid_t を含む string を解析することもできます。入力文字列の長さは 24 文字以上である必要があります。

bson_oid_t oid;
bson_oid_init_from_string (&oid, "123456789012345678901234");

bson_oid_t oid;
bson_oid_init_from_string_unsafe (&oid, "123456789012345678901234");

オブジェクト ID のハッシュ

ハッシュテーブルに項目を保存する必要がある場合は、 bson_oid_t をキーとして使用することをお勧めします。libbson はこの目的のみでハッシュ関数を提供します。JB ハッシュに基づいています。

unsigned hash;
hash = bson_oid_hash (oid);

ObjectId作成時間の取得

bson_oid_get_time_t を使用して、 bson_oid_t が生成された時間を簡単に取得できます。

time_t t;
t = bson_oid_get_time_t (oid);
printf ("The OID was generated at %u\n", (unsigned) t);