BSON_ITER_OID(3)

💅 BSON_ITER_OID 💅

okay so bestie, welcome to bson_iter_oid — that's section 3 of the libbson manual, and honestly? she's a short one but she's iconic. let's get into it 🫶

---

✨ SYNOPSIS ✨

#define BSON_ITER_HOLDS_OID(iter) (bson_iter_type ((iter)) == BSON_TYPE_OID)

const bson_oid_t *
bson_iter_oid (const bson_iter_t *iter);

literally two things and both are perfect, no notes 💖

---

🎀 PARAMETERS 🎀

• iter — a bson_iter_t. that's it. that's the whole cast of characters 🦋

---

🌸 DESCRIPTION 🌸

so the way this works is: bson_iter_oid fetches the bson_oid_t for a BSON_TYPE_OID element. slay. but — and this part is important, bestie, don't skip it — you should verify it's an element of type BSON_TYPE_OID before calling this function. like, vibe check your iterator first, okay? 😭 that's literally what the BSON_ITER_HOLDS_OID(iter) macro up in the synopsis is for, iykyk 👑

---

🦋 RETURNS 🦋

a bson_oid_t that should not be modified or freed — ngl it's not yours, it's giving borrowed-and-you-must-not-touch. look respectfully and move on 🙈✨

---

⭐ AUTHOR ⭐

MongoDB, Inc — yeah, the MongoDB girlies wrote this one 👑

---

🌈 COPYRIGHT 🌈

2009-present, MongoDB, Inc. — protect the intellectual property, periodt 💅

---

and that's the whole page, bestie!! you ate that reading. this was libbson 2.5.6, dated Oct 09, 2026 — write it down, take a picture, it'll last longer 🎀📸💜