オブジェクト ID

構成

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

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

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

オブジェクト ID のソート

C で並べ替える一般的な方法は、 qsort()を使用することです。 したがって、libson はqsort() bson_oid_comparent という名前の 互換コールバック関数を提供します 。2 つの bson_id_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_id_t を含む string も解析できます 。入力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_t が は bson_oid_get_time_t を使用して生成されました。

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