MONGOC_GRIDFS_FIND(3)

💖 MONGOC_GRIDFS_FIND 💖

okay bestie, buckle up, we're in the libmongoc manual and this one's giving legacy icon ✨

⚠️ WARNING, and I mean it: Deprecated since version 1.5.0 — this function is deprecated, use mongoc_gridfs_find_with_opts() instead. she's retired, she's living her best life, please stop calling her 💀

---

🌸 SYNOPSIS 🌸

mongoc_gridfs_file_list_t *
mongoc_gridfs_find (mongoc_gridfs_t *gridfs,
                    const bson_t *query);

---

🎀 PARAMETERS 🎀

• gridfs — a mongoc_gridfs_t. that's the whole vibe, that's the whole type 💅
• query — a bson_t. yes bestie, the query. the thing you're searching for 🍓

---

✨ DESCRIPTION ✨

so what does she actually do? she finds all the gridfs files matching query, that's it, that's the job 🫶 and then you can iterate over all those matched gridfs files with the resulting file list. cute, right?

now here's the lowkey important part: this function is considered a retryable read operation. what that means fr fr is that upon a transient error — like a network error, or errors due to replica set failover, etc. — the operation is safely retried once. she gets one (1) second chance, no cap 😌

but wait, there's a catch 👀 if retryreads is false in the URI (see mongoc_uri_t), the retry behavior does not apply. so check your URI before you assume she's got your back, bestie.

---

🌈 RETURNS 🌈

a newly allocated mongoc_gridfs_file_list_t 👑

and because she's newly allocated, you must free her with mongoc_gridfs_file_list_destroy() when no longer in use. don't be the person who leaks memory, that's not main character energy, that's just messy 🙈

---

👑 AUTHOR 👑

MongoDB, Inc

---

💜 COPYRIGHT 💜

2009-present, MongoDB, Inc.

---

and that's the whole page, bestie!! 🦋 this was libmongoc version 1.30.13, dated Oct 09, 2026 — go forth, use mongoc_gridfs_find_with_opts() instead, and hydrate 💖✨🧚