MONGOC_DATABAS...LLECTION_NAMES(3)

🎀 MONGOC_DATABAS...LLECTION_NAMES(3) 🎀

okay bestie sit down because we're talking about mongoc_database_get_collection_names(), and she comes from libmongoc 💖 (yes the whole manual is filed under MONGOC_DATABAS...LLECTION_NAMES(3), the name is just a little long, she's dramatic like that).

---

⚠️ WARNING ⚠️

Deprecated since version 1.9.0 😭 bestie she's retired, she's a legacy icon, she's on the shelf.

Use mongoc_database_get_collection_names_with_opts() instead. Periodt. That's the glow-up version.

---

✨ SYNOPSIS ✨

char **
mongoc_database_get_collection_names (mongoc_database_t *database,
                                      bson_error_t *error);

---

💅 DESCRIPTION 💅

She fetches a NULL terminated array of NULL-byte terminated char* strings, and those strings contain the names of all of the collections in database. Like, every single one, all the receipts, no cap 🧚

This function is considered a retryable read operation. So if a transient error happens — think a network error, errors due to replica set failover, etc. — the operation is safely retried once 🫶

But listen: if retryreads is false in the URI (see mongoc_uri_t), the retry behavior does not apply. No retries, no safety net, she simply vibes with the consequences 💀

---

🌸 PARAMETERS 🌸

• database — A mongoc_database_t. This is the database she's snooping through, main character energy only.
• error — An optional location for a bson_error_t, or NULL. Optional!! If you don't want to hear about it, she won't tell you 🙈

---

😭 ERRORS 😭

Errors are propagated via the error parameter. So if something goes wrong, that's where it shows up — check your error, babe.

---

⭐ RETURNS ⭐

A NULL terminated array of NULL terminated char* strings — and heads up, you must free it with bson_strfreev(). Clean up after yourself, we don't leave mess 💅

Upon failure, NULL is returned and error is set. That's the "it's giving nothing" outcome. 💀

---

👑 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 (the year got cut off in the footer, she's mysterious like that 😌), and the manual page sign-off is MONGOC_DATABAS...LLECTION_NAMES(3) because of course it is. stay hydrated, free your arrays, mwah 💖✨🦋