BSON_ITER_FIND_DESCENDANT(3)

💅 BSON_ITER_FIND_DESCENDANT(3) ✨

okay so this is a libbson page, bestie — we're in bson_iter_find_descendant territory and it's genuinely so useful, no cap 🫶

---

🌸 SYNOPSIS 🌸

like, the whole vibe in code form:

bool
bson_iter_find_descendant (bson_iter_t *iter,
                           const char *dotkey,
                           bson_iter_t *descendant);

---

🎀 PARAMETERS 🎀

• iter — a bson_iter_t. yes. that's the whole description. it's an iterator, she's the main character, we love her 💅
• dotkey — a dot-notation key like "a.b.c.d". the dots are literally the whole point, iykyk 🦋
• descendant — another bson_iter_t. this one gets to be the destination, lucky her ✨

---

💖 DESCRIPTION 💖

so bson_iter_find_descendant() shall follow standard MongoDB dot notation to recurse into subdocuments — like it literally dives down through your "a.b.c.d" and keeps going, obsessed 🔥

descendant will be initialized and advanced to the descendant. she gets set up and moved into place, ate 💀

⚠️ but listen — if false is returned, both iter and descendant should be considered invalid. like, do not touch them, do not pass go, they are Done 🙈

---

⭐ RETURNS ⭐

true is returned if the requested key was found. slay 👑

if not, false is returned and iter was exhausted and should now be considered invalid. she's tired. let her rest 😭

---

👑 AUTHOR 👑

MongoDB, Inc — the icons themselves 💜

---

🌈 COPYRIGHT 🌈

2009-present, MongoDB, Inc. — periodt 🎀

---

k bye bestie, go find those descendants 🧚💖

this has been libbson version 2.5.6, dated Oct 09, 2026 — catch you on the flip side 🦋