EC_COMP_ADD_ITEM(3)

💖 EC_COMP_ADD_ITEM(3) 💖

okay bestie, welcome to the Libecoli Programmer's Manual — today's episode is all about ec_comp_add_item, and honestly? it's giving completion-list royalty ✨

---

🌸 NAME 🌸

ec_comp_add_item — drop a lil item into the completion list 🎀

---

✨ SYNOPSIS ✨

#include <ecoli/complete.h>

struct ec_comp_item * ec_comp_add_item(
    struct ec_comp         *comp,     /* The current completion list. */
    const struct ec_node   *node,     /* The node issuing the completion item. */
    enum ec_comp_type       type,     /* The type of the item. */
    const char             *current,  /* The incomplete string being completed. */
    const char             *full      /* The string fully completed. */
);

---

💅 DESCRIPTION 💅

so basically, this is the function a node calls during the completion process — once for every single completion item that should get added to the list. no cap. the nodes that do this are typically the terminal ones, like ec_node_str() or ec_node_file(). they're the ones on the front lines fr fr 🫶

what it does: creates a brand new completion item and yeets it straight into the completion list. and every completion item has a type, which can be… 👀 (scroll down to STRUCTURES bestie, we got you)

---

🦋 STRUCTURES 🦋

the type menu, fresh off the press:

enum ec_comp_type {
      EC_COMP_UNKNOWN;
      EC_COMP_FULL;
      EC_COMP_PARTIAL;
      EC_COMP_ALL;
};

---

👑 RETURN VALUE 👑

on success you get back the item that was added to the list. on error? you get NULL. 😭

do NOT free the returned value, bestie. it's referenced by the completion list, so it's not yours to delete, periodt. 💀

it gets returned to you anyway, in case you need to modify it — for instance with ec_comp_item_set_display(). iconic behavior tbh.

---

🌈 SEE ALSO 🌈

the whole friend group, all invited to the group chat:

• ec_comp_count(3)
• ec_comp_item_set_str(3)
• ec_complete(3)
• ec_comp_get_attrs(3)
• ec_comp_group_get_attrs(3)
• ec_comp_iter_next(3)
• ec_comp_item_get_node(3)
• ec_comp_iter_first(3)
• ec_comp_item_get_current(3)
• ec_comp_group_get_node(3)
• ec_complete_strvec_expand(3)
• ec_comp_free(3)
• ec_comp_get_cur_pstate(3)
• ec_complete_unknown(3)
• ec_complete_strvec(3)
• ec_comp_item_get_grp(3)
• ec_comp_item_get_type(3)
• ec_comp_item_get_str(3)
• ec_comp_item_set_display(3)
• ec_complete_child(3)
• ec_comp(3)
• ec_comp_item_get_display(3)
• ec_comp_item_get_completion(3)
• ec_comp_group_get_pstate(3)
• ec_comp_dump(3)
• ec_comp_merge(3)
• ec_comp_item_set_completion(3)
• ec_comp_get_cur_group(3)

---

💜 COPYRIGHT 💜

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

---

and that's the whole page, bestie 🍓 this lil manual moment comes to you courtesy of libecoli, dated 2026-06-11, and it lives at EC_COMP_ADD_ITEM(3). mwah 💋 go forth and complete some strings ✨🧚