BSON_ITER_DBPOINTER(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💅 BSON_ITER_DBPOINTER 💅

okay so bestie, this is a libbson page — the manual name is libbson and the whole thing is filed under BSON_ITER_DBPOINTER(3), section 3, iykyk. it's about pulling the guts out of one very specific, very deprecated little BSON type. let's get into it 🫶

✨ SYNOPSIS ✨

void
bson_iter_dbpointer (const bson_iter_t *iter,
                     uint32_t *collection_len,
                     const char **collection,
                     const bson_oid_t **oid);

that's the whole signature, no cap. four args, returns void. that's it, that's the function 🎀

🌸 PARAMETERS 🌸

  • iter — a bson_iter_t. your iterator, your main character. 💖
  • collection_len — a location for the length of the collection name.
  • collection — a location for the collection name.. (yes, the original has two dots there, i'm not fixing it, i'm respecting the source material 😭)
  • oid — a location for a bson_oid_t.

all four are pointers-to-things you're handing over so the function can fill them in. very demure, very "you provide the storage, i provide the data" energy ✨

🦋 DESCRIPTION 🦋

okay so what does it actually do? it fetches the contents of a BSON_TYPE_DBPOINTER element. that's the whole job. it reaches in, grabs the collection name length, the collection name, and the bson_oid_t, and drops them into the locations you passed in. slay 💅

⚠️ WARNING: the BSON_TYPE_DBPOINTER field type is deprecated by the BSON spec and should not be used in new code. fr fr, do not do it. this is not a vibe, this is a warning. if you're writing brand new code and you're reaching for this, bestie, put it down 🚨💀

the function still exists so you can read old data that has it, but new code? absolutely not. periodt.

👑 AUTHOR 👑

MongoDB, Inc

2009-present, MongoDB, Inc.

and that's the page, bestie! 🎀 version 2.5.6, dated Oct 09, 2026 — thanks for reading, mwah 💖✨🦋

📦 where this page comes from