BSON_ITER_FIND(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💅 BSON_ITER_FIND(3) 💅

okay so this is the libbson manual page for bson_iter_find(), and bestie, it’s lowkey iconic for finding exactly one key in your BSON iterator. no cap. 🦋

✨ SYNOPSIS ✨

bool
bson_iter_find (bson_iter_t *iter, const char *key);

🎀 PARAMETERS 🎀

  • iter — A bson_iter_t. the main character iterator we’re moving around 💫
  • key — A string containing the requested key. the name you’re hunting for 🔎

🌸 DESCRIPTION 🌸

The bson_iter_find() function shall advance iter to the first element named key or exhaust all elements of iter. it’s giving “go find your fave and don’t come back until you do” 💅

If iter is exhausted, false is returned and iter should be considered invalid. like, fr fr, that iterator is done-zo after that 😭

Heads up, bestie: key is case-sensitive. For a case-folded version, see bson_iter_find_case(). iykyk 🫶

⭐ RETURNS ⭐

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

If not, iter was exhausted and should now be considered invalid. not me getting emotionally attached to an iterator that’s literally invalid now 💀

👑 AUTHOR 👑

MongoDB, Inc

2009-present, MongoDB, Inc.

mwah 💋 this cutie is from libbson 2.5.6, dated Oct 09, 2026 — catch you in the next manpage, bestie 🌈🫶

📦 where this page comes from