EC_HTABLE_GET(3)

✨ EC_HTABLE_GET ✨

okay bestie, welcome to EC_HTABLE_GET(3) from the Libecoli Programmer's Manual 💖 this one is short and sweet but she is important, so pay attention.

---

🌸 NAME 🌸

ec_htable_get — get a value from the hash table. that's it. that's the whole job. she fetches. she serves. 💅

---

🎀 SYNOPSIS 🎀

first, the include. you gotta include her or she will not show up, no cap:

#include <ecoli/htable.h>

and here's the whole function, in all her glory ✨

void * ec_htable_get(
    const struct ec_htable   *htable,   /* The hash table. */
    const void               *key,      /* The key. */
    size_t                    key_len   /* The key length. */
);

three args, three vibes:

• htable — the hash table. the main character. the const struct ec_htable * you're pulling from.
• key — the key. a const void *, so she doesn't really care what shape your key is, she's just holding it.
• key_len — the key length, a size_t. the way that she literally needs to know how many bytes of key she's looking at… yeah. tell her.

---

🦋 RETURN VALUE 🦋

so what comes back?

• if the element is found, you get the element. slay. 🎉
• if there's an error, you get NULL, and errno is set.
• and here's the spicy bit: if it succeeds but the element itself is NULL, then errno is set to 0. 🫠

so like, NULL does NOT automatically mean error, bestie. you have to actually check errno to know which universe you're in. it's giving "looks the same, means different things" energy. 😭

---

👑 SEE ALSO 👑

go read her friends too, they're all iconic in their own way:

• 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_set(3)
• ec_htable_free(3)
• ec_htable_iter(3)

---

💜 COPYRIGHT 💜

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

---

and that's the whole page, bestie 🧚 go get that value 💖

this has been libecoli, dated 2026-06-11, and you have officially read EC_HTABLE_GET(3) all the way to the end 🎀⭐ mwah 💋