BSON_ITER_INT32(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💅 BSON_ITER_INT32 — the libbson glow-up you didn't know you needed

okay so bestie, welcome to BSON_ITER_INT32(3), a libbson page about pulling a little 32-bit number out of a BSON iterator, and honestly? it's giving "small function, big main character energy." ✨

✨ SYNOPSIS ✨

#define BSON_ITER_HOLDS_INT32(iter) (bson_iter_type ((iter)) == BSON_TYPE_INT32)

int32_t
bson_iter_int32 (const bson_iter_t *iter);

two things up top, and you're gonna want both of them, no cap: a macro that vibe-checks your iterator, and the function that actually hands over the goods. 🫶

🎀 PARAMETERS 🎀

  • iter — a bson_iter_t. that's it. that's the whole parameter list. she's low maintenance, she's iconic. 💅

🔥 DESCRIPTION 🔥

so what does she do? bson_iter_int32() fetches the value out of a BSON_TYPE_INT32 element. literally just yoinks the number out of there and hands it to you. 🍓

but listen — and this is the important part, so like, actually listen — you should verify that the field is a BSON_TYPE_INT32 field before calling this function. don't just roll up and assume. do the vibe check first, bestie.

and conveniently, the boys at libbson handed you the exact vibe-check tool in the synopsis: BSON_ITER_HOLDS_INT32(iter) compares bson_iter_type ((iter)) against BSON_TYPE_INT32 so you can confirm it's the right type before you commit. use it. it's right there. 💀

👑 RETURNS 👑

a 32-bit integer. that's the whole flex. int32_t, thirty-two bits of pure value, delivered straight to your call site. 🎀

🌈 AUTHOR 🌈

MongoDB, Inc — the folks who brought you the whole bson_iter_t cinematic universe. 🦋

2009-present, MongoDB, Inc. — an absolutely generational run, fr fr. 👑

so that's the whole page, babe — short, sweet, and honestly kinda slay. this little gem comes to you courtesy of libbson, version 2.5.6, dated Oct 09, 2026. go forth, check your types first, and iterate responsibly. 💖🧚✨

📦 where this page comes from