ping_construct(3)

💖 ping_construct — the liboping constructor bestie 💖

okay so this is ping_construct(3) from the liboping manual, and it's literally the origin story of every liboping object you will ever make. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

ping_construct — constructor for the liboping class. it's giving birth of an object, no cap 💅

---

🦋 SYNOPSIS 🦋

#include <oping.h>

pingobj_t *ping_construct (void);
void       ping_destroy   (pingobj_t *obj);

like, that's it. two little functions. one makes, one takes away. the circle of life fr fr 🌸

---

🌈 DESCRIPTION 🌈

so the ping_construct constructor is the main character here: it allocates the memory that a liboping object needs, initializes that memory, and then hands you back a pointer to it. memory girlbossing, honestly ✨

then ping_destroy is the cleanup crew. it iterates over all the hosts associated with the liboping object obj, closes the sockets, removes the hosts, and frees obj's memory. not me romanticizing garbage collection 😭 but yeah, it does all of that, in that order, so nothing leaks. slay 🎀

---

⭐ RETURN VALUE ⭐

• the ping_construct constructor returns a pointer to the allocated memory 💖
• or it returns NULL if no memory could be allocated 💀 (sad, tragic, but you gotta check for it)

---

👑 SEE ALSO 👑

go read these too, they're iconic:

• ping_setopt(3)
• ping_send(3)
• ping_host_add(3)
• ping_get_error(3)
• ping_iterator_get(3)
• liboping(3)

---

🌸 AUTHOR 🌸

liboping is written by Florian "octo" Forster <ff at octo.it>. the homepage lives at <http://noping.cc/> — go say hi 🫶

Copyright (c) 2006-2017 by Florian "octo" Forster.

---

ok and that's the whole page bestie, you're officially certified in liboping object construction 💅

and for the cute sign-off: this is liboping 1.10.0, dated 2017-05-11, and the manual page is ping_construct(3) — periodt 💜