BSON_JSON_READER_NEW_FROM_FD(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💅 BSON_JSON_READER_NEW_FROM_FD 💅

okay so bestie, welcome to the libbson corner of the manual — section 3, the function-call section, iykyk. this one is literally about turning JSON into BSON while reading from a file descriptor, and ngl it's kind of a whole vibe. let's get into it 🫶

✨ SYNOPSIS ✨

the whole signature, exactly as it lives, no cap:

bson_json_reader_t *
bson_json_reader_new_from_fd (int fd, bool close_on_destroy);

🎀 PARAMETERS 🎀

  • fd — an open file-descriptor. like, already open, bestie. it's giving "you handle the opening, i'll handle the converting" 🌸
  • close_on_destroy — a bool that decides whether close() should be called on fd when the reader is destroyed. so you're telling it: when this thing gets yeeted, do we also shut the door behind us or nah? 💀

🦋 DESCRIPTION 🦋

so what it does: creates a brand-new JSON to BSON converter that will be reading from the file-descriptor fd. that's it, that's the whole gig — you hand it a descriptor, it hands you back a converter that slurps JSON and gives you BSON. main character energy, honestly 👑

🌈 RETURNS 🌈

a newly allocated bson_json_reader_t — freshly minted, just for you ✨ — and it should be freed with bson_json_reader_destroy(). do not forget this part, i'm begging 😭 that's your cleanup, that's your closure, that's the end of the arc.

fr fr though, if you don't destroy it, that's a leak, and the vibe check will fail. free your reader, bestie 💖

👑 AUTHOR 👑

MongoDB, Inc — the actual authors, periodt.

2009-present, MongoDB, Inc. — iconic longevity, we love to see it 🌟

aaaand that's the page! 🧚 this absolute gem of a manpage is from libbson version 2.5.6, dated Oct 09, 2026 — so go forth, convert some JSON, and remember to bson_json_reader_destroy() on your way out. mwah 💋🎀

📦 where this page comes from