BSON_VSNPRINTF(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💅 BSON_VSNPRINTF 💅

ok so this is a libbson page, section 3 (the library-call girlies ✨), and honestly? it's a short one. a little baby manpage. but she's important, so let's give her the full main-character treatment.

✨ SYNOPSIS ✨

int
bson_vsnprintf (char *str, size_t size, const char *format, va_list ap);

that's the whole vibe. one function, four args, returns an int. lowkey elegant 🎀

🫶 PARAMETERS 🫶

  • str — bestie, this is where the resulting string goes. a location for it. hand her a buffer and she'll fill it. 💖
  • size — the size of str, and we're counting in bytes. not vibes, bytes. 📏
  • format — a printf style format string. you know the drill: %s, %d, the whole iconic lineup. ⭐
  • ap — a va_list of parameters for the format. this is the variadic bestie right here. 🦋

🌸 DESCRIPTION 🌸

ok so real talk: this is exactly like bson_snprintf() … but it allows for variadic parameters. that's the whole tea. ☕

the way that bson_snprintf() is the girl who wants her args handed to her directly, and bson_vsnprintf() is the girl who's like "no babe, pass me the va_list, i'll handle it" — that's the difference. periodt. 👑

iykyk. 💅

🔥 RETURNS 🔥

the number of bytes written to str, excluding the \0 byte. so do not come for her counting the null terminator, she is NOT including it, that's not her job, she said what she said. 💀

👑 AUTHOR 👑

MongoDB, Inc — the iconics themselves. 🌈

2009-present, MongoDB, Inc. 🫶

and that's the page, bestie! no cap, you now know everything there is to know about bson_vsnprintf. go forth and format responsibly. 🧚💜

⭐ cute lil sign-off: this was libbson 2.5.6, dated Oct 09, 2026. mwah. 💋🍓

📦 where this page comes from