EC_COMPLETE(3)

💖 EC_COMPLETE 💖

okay bestie, so this is a page from the Libecoli Programmer's Manual, and it's all about ec_complete — the function that pulls your completion list out of a plain string. get comfy, we're doing this 💅

---

✨ NAME ✨

ec_complete — literally just "gimme the list of completions from a string input." that's the whole gig 🎀

---

🌸 SYNOPSIS 🌸

#include <ecoli/complete.h>

struct ec_comp * ec_complete(
    const struct ec_node   *node,  /* The grammar graph. */
    const char             *str    /* The input string. */
);

---

🦋 DESCRIPTION 🦋

so the way this works is: ec_complete() is equivalent to calling ec_complete_strvec() with a vector that only contains 1 element — that element being the input string. periodt. no cap.

and honestly? using this one is often more convenient if you're getting your input from a buffer, because then you don't have to go build a whole vector yourself. slay, less work 🫶

usually what that means is you've got a lexer hanging out in your grammar graph that's gonna tokenize the input for you. iconic behaviour honestly.

for the full deets, go read ec_complete_strvec() — that's where the details live. iykyk.

---

⭐ RETURN VALUE ⭐

• on success? you get a pointer to the completion list. chef's kiss 👑
• on error? you get NULL, and errno gets set. (the vibe check failed, bestie 😭)

---

💜 SEE ALSO 💜

the whole friend group, fr fr:

• ec_comp_add_item(3)
• ec_comp_count(3)
• ec_comp_item_set_str(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.

---

okay that's the whole page, bestie!! this one came from libecoli, dated 2026-06-11 — like, it's giving timeless, it's giving maintained 🧚💖 go forth and complete ur strings, mwah 💜✨