EC_DICT_ITER_GET_KEY(3)

💖 EC_DICT_ITER_GET_KEY(3) 💖

okay bestie, welcome to the Libecoli Programmer's Manual ✨ this one's a lil baby page but she's important, so pay attention 🎀

---

🌸 NAME 🌸

ec_dict_iter_get_key — Get a pointer to the key of the current element.

like. that's it. that's the whole job. she hands you a pointer to the key of the element your iterator is sitting on rn. no cap 💅

---

✨ SYNOPSIS ✨

#include <ecoli/dict.h>

const char * ec_dict_iter_get_key(
    const struct ec_dict_elt_ref   *iter   /* The hash table iterator. */
);

so you're passing in iter — that's your hash table iterator, a const struct ec_dict_elt_ref * 🦋 — and she gives you back a const char *. simple as that, fr fr.

---

🫶 RETURN VALUE 🫶

she returns the current element key ✨

OR, and hear me out, she returns NULL if the iterator points to an invalid element 😭 so like. check for that. don't be out here dereferencing vibes.

---

👑 SEE ALSO 👑

your girl does not exist in a vacuum, she's got a whole friend group 💖 go say hi:

• ec_dict_iter(3)
• ec_dict_has_key(3)
• ec_dict_free(3)
• ec_dict_iter_get_val(3)
• ec_dict_len(3)
• ec_dict_dup(3)
• ec_dict_del(3)
• ec_dict(3)
• ec_dict_set(3)
• ec_dict_get(3)
• ec_dict_dump(3)
• ec_dict_iter_next(3)

---

🎀 COPYRIGHT 🎀

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

---

💀 reminder bestie: NULL is a real return value here, not a personality trait. check it before you use it. periodt.

okay that's the page!! this doc came from libecoli and the date on her birth certificate says 2026-06-11 🗓️✨ she ate, honestly. love that for her. mwah 💅💖🌸🦋