MONGOC_GRIDFS...LOAD_TO_STREAM(3)

🌸 MONGOC_GRIDFS...LOAD_TO_STREAM(3) 🌸

okay bestie, so this little cutie lives in libmongoc — that's the manual name, iykyk — and it's all about slurping a file out of GridFS and yeeting it straight into a stream. no cap, it's giving very demure, very mindful. 💅

---

✨ SYNOPSIS ✨

bool
mongoc_gridfs_bucket_download_to_stream (mongoc_gridfs_bucket_t *bucket,
                                         const bson_value_t *file_id,
                                         mongoc_stream_t *destination,
                                         bson_error_t *error);

like, that's the whole vibe right there 🫶

---

🎀 PARAMETERS 🎀

• bucket — a mongoc_gridfs_bucket_t. this is your main character, the bucket we're pulling from ✨
• file_id — a bson_value_t holding the id of the file you wanna download. know the id, get the file, periodt 🔥
• destination — a mongoc_stream_t that receives the data from the downloaded file. it's literally the bucket for your bytes 🌈
• error — a bson_error_t where any error gets dropped off, or NULL if you're feeling unbothered 🙈

---

💖 DESCRIPTION 💖

So what it does: it reads from the GridFS file and writes to the destination stream. simple as. 🦋

It writes the full contents of the file to the destination stream. but bestie, listen — the destination stream is not closed after calling mongoc_gridfs_bucket_download_to_stream(); you gotta call mongoc_stream_close() after. don't leave it hanging, that's rude 😭

This function is considered a retryable read operation. so when a transient error shows up (a network error, errors due to replica set failover, etc.) the operation is safely retried once. one (1) little second chance, iconic behaviour honestly 👑

tiny caveat though — if retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply. so like, no retries for you, hydrate and know your settings 💀

---

⭐ RETURNS ⭐

True if the operation succeeded. False otherwise, and sets error — so check that error bestie, it's telling you something 🍓

👀 SEE ALSO 👀

• mongoc_stream_file_new() and mongoc_stream_file_new_for_path() — which can be used to create a destination stream from a file. genuinely obsessed with these two, they make the destination stream situation a whole vibe 🧚

---

💜 AUTHOR 💜

MongoDB, Inc — yeah, that MongoDB 💜

🎀 COPYRIGHT 🎀

2009-present, MongoDB, Inc. protected and everything, periodt 💅

---

and that's the whole page bestie!! 🌸 this was libmongoc version 2.5.6, dated Oct 09, 2026 — write it down, remember it, tattoo it on your heart, mwah 🫶💖✨