EC_HTABLE_SET(3)

💖 EC_HTABLE_SET 💖

okay so bestie, welcome to the Libecoli Programmer's Manual ✨ this is the page for ec_htable_set(3) and honestly? she's a baddie. she puts stuff in your hash table. that's it. that's the job. 👑

---

🌸 NAME 🌸

ec_htable_set — add or replace an object in the hash table. literally just drop it in there 💅

---

✨ SYNOPSIS ✨

#include <ecoli/htable.h>

int ec_htable_set(
    struct ec_htable     *htable,   /* The hash table. */
    const void           *key,      /* The key. */
    size_t                key_len,  /* The key length. */
    void                 *val,      /* The pointer to be saved in the hash table. */
    /*
     * An optional pointer to a destructor function called when an object is
     * destroyed (ec_htable_del() or ec_htable_free()).
     */
    ec_htable_elt_free_t  free_cb
);

no cap, that's the whole vibe. you hand her the table, the key, how long that key is, the pointer you wanna stash, and a lil cleanup callback. 🎀

---

🔥 RETURN VALUE 🔥

• 0 on success — slay, it worked, main character energy 🌈
• -1 on error, and errno gets set so you can go find out what went wrong 👀

⚠️ okay this part matters fr fr: on error, the value you passed in is freed — as in free_cb(val) gets called. so do NOT go touching that pointer after a -1, she's gone, she's in her deleted era 💀

---

🦋 SEE ALSO 🦋

the whole friend group, go say hi:

• ec_htable_iter_get_key(3)
• ec_htable_iter_get_val(3)
• ec_htable_iter_next(3)
• ec_htable_has_key(3)
• ec_htable_len(3)
• ec_htable(3)
• ec_htable_force_seed(3)
• ec_htable_dup(3)
• ec_htable_iter_get_key_len(3)
• ec_htable_dump(3)
• ec_htable_del(3)
• ec_htable_get(3)
• ec_htable_free(3)
• ec_htable_iter(3)

---

👑 COPYRIGHT 👑

Copyright (C) 2010-2026 Olivier Matz, Robin Jarry.

---

and that's the page bestie, iykyk 🫶 this was libecoli, dated 2026-06-11, and the page is EC_HTABLE_SET(3) — obsessed with her honestly, go set some keys 💖✨🌸