EC_INTERA...END_CHARS(3)

✨ EC_INTERA...END_CHARS(3) ✨

okay so bestie, welcome to the Libecoli Programmer's Manual 💖 this one's a lil three-parter situation, and we're gonna walk through it together, no cap.

---

🎀 NAME 🎀

ec_interact_append_chars — she gets you the characters to append to the line for a completion. that's it, that's the job. 💅

---

🌸 SYNOPSIS 🌸

#include <ecoli/interact.h>

char * ec_interact_append_chars(
    /*
     * The completion object containing all the completion items.
     */
    const struct ec_comp   *cmpl
);

so you're passing in cmpl, which is literally the completion object holding all the completion items. she's const too, so you're not messing with her, just vibing with her data. 🦋

---

💖 RETURN VALUE 💖

so what do you get back? an allocated string ✨ — one that's meant to be appended to the current line. and listen, this is the important part, bestie:

the caller has to free it with free(). not optional. that's your string now, you own it, you clean it up. 🧹

now, this string can be empty in two cases:

• there's no completion at all, or
• the completions start with a different letter (so nothing matches, rip 💀)

and if something goes wrong? it returns NULL. that's the error vibe. 😭

---

👑 SEE ALSO 👑

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

• ec_interact_get_completions(3)
• ec_interact_print_helps(3)
• ec_interact_print_error_helps(3)
• ec_interact_print_cols(3)
• ec_interact_set_help(3)
• ec_interact_set_desc(3)
• ec_interact_get_callback(3)
• ec_interact_set_callback(3)
• ec_interact_get_error_helps(3)
• ec_interact_free_completions(3)
• ec_interact_get_helps(3)
• ec_interact_free_helps(3)

iykyk 🌈

---

🫶 COPYRIGHT 🫶

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

---

and that's the whole page, bestie!! 🎀 huge thanks to the libecoli girlies for this one — this page was last touched on 2026-06-11, so you know it's fresh. slay, go complete some lines. periodt 💅✨💖