MDEX_PUT(3)

💖 MDEX_PUT(3) 💖

okay bestie, gather round, it's mdex_put from the Librecast Programmer's Manual and she is so much simpler than she looks 🫶

✨ NAME ✨

mdex_put — insert an entry into a multicast index 🌈

📚 LIBRARY 📚

Librecast library (liblibrecast, -llibrecast) 💅

🎀 SYNOPSIS 🎀

#include <librecast/mdex.h>

int mdex_put(mdex_t *mdex, unsigned char *hash, size_t hashlen, mdex_entry_t *entry);

Compile and link with -llibrecast. ✨

🦋 DESCRIPTION 🦋

so basically? mdex_put takes the value of entry and stores it in the multicast index mdex, using hash (of length hashlen) as the key. like, the hash is the lil name tag and the entry is the whole personality, and they get introduced to each other. 💖

and here's the iconic part: entry may be NULL, and an entry will still be created. no entry? no problem. the key still gets to exist. main character energy fr fr. 👑

⭐ RETURN VALUE ⭐

mdex_put() returns zero on success — slay. 🎉

On error, -1 is returned, and errno is set to indicate the error. (yes she's telling on herself, that's the whole point.) 😭

💀 ERRORS 💀

• EINVAL — Invalid argument. bestie listen. both mdex and hash are required (not NULL), and hashlen must be > 0. no empty vibes allowed, no vibe check passed with a null, none of it. 🙈
• ENOMEM — Not enough space/cannot allocate memory (POSIX.1-2001). the memory said "not today" and honestly? valid. 💀

👑 SEE ALSO 👑

mdex_init(3), mdex_free(3), mdex_get(3), mdex_del(3), lc_share(3) — the whole friend group, go say hi. 🫶🌸

mwah 💋 this page came straight from the Librecast crew, dated 2023-06-20, and yeah — it's page MDEX_PUT(3) of the Librecast Programmer's Manual. that's the whole thing bestie, go put some entries in a multicast index and text me when it works. 💜✨