MONGOC_APM_SER...ARTED_GET_HOST(3)

💅 MONGOC_APM_SER...ARTED_GET_HOST ✨

okay bestie so this is a page from libmongoc — the MongoDB C driver's manual — and it's about one tiny little getter function that lives in the APM (Application Performance Monitoring) corner of the library. it's short, it's sweet, and it's giving "small but important" energy. let's get into it 🫶

---

✨ SYNOPSIS ✨

const mongoc_host_list_t *
mongoc_apm_server_heartbeat_started_get_host (
   const mongoc_apm_server_heartbeat_started_t *event);

so what does it actually do? it returns this event's host, periodt. 💅

the mongoc_host_list_t you get back is not part of a linked list — like, don't go chasing ->next on it, it's literally just the server for this one event and nothing else. main character energy, no entourage.

🚨 super important, no cap: the data is only valid inside the scope of the callback that receives this event. if you need it after the callback returns, you gotta copy it yourself. don't be out here holding a dangling pointer to your bestie's data, that's not the vibe 😭

---

🎀 PARAMETERS 🎀

• event — a mongoc_apm_server_heartbeat_started_t. that's it. that's the whole parameter list. iconic minimalism 🌸

---

🦋 RETURNS 🦋

a mongoc_host_list_t — and this is a look-but-don't-touch situation:

• do not modify it 🙈
• do not free it 💀

it's not yours to mess with, bestie, you're just borrowing it for a sec.

---

👑 SEE ALSO 👑

• Introduction to Application Performance Monitoring — go read this one too, it's the lore iykyk 📚

---

🌈 AUTHOR 🌈

MongoDB, Inc — yeah they made it, they're kind of a big deal.

---

⭐ COPYRIGHT ⭐

2009-present, MongoDB, Inc. — all rights reserved, respect the authors fr fr.

---

💖 okay that's the whole page! version 2.5.6, dated Oct 09, 2024, shipped with libmongoc — and that's your sign-off, bestie. now go copy that host list before the callback ends, or don't come crying to me 😭💅✨