EC_EDITLINE_INTERACT(3)

✨ EC_EDITLINE_INTERACT(3) ✨

okay bestie, so this one's from the Libecoli Programmer's Manual, and it's genuinely the moment your lil command line finally starts talking back 💬💖

---

🎀 NAME 🎀

ec_editline_interact — hang out with the user until they dip. that's it, that's the whole vibe. no cap.

---

🌸 SYNOPSIS 🌸

#include <ecoli/editline.h>

int ec_editline_interact(
    struct ec_editline          *editline,       /* The pointer to the ec_editline structure. */
    /*
     * Optional function pointer executed before each loop iteration to check
     * if loop should be exited (when the function return true).
     */
    ec_editline_check_exit_cb_t  check_exit_cb,
    void                        *opaque          /* User pointer, passed as-is to check_exit_cb(). */
);

---

🦋 DESCRIPTION 🦋

so basically, this function runs the command line for you 💅 it parses and completes commands on demand — like, whenever, no stress, main character energy fr.

the way that when a command gets parsed successfully, it goes and invokes the callback that's attached to the grammar node as an EC_INTERACT_CB_ATTR attribute 👑 and heads up: that callback type must be ec_interact_command_cb_t. no substitutions bestie, it's giving strict.

on EOF, or if the check_exit() function returns true, it dips out of the interactive loop 🚪✨ iconic exit, honestly.

lowkey important: that check_exit_cb is optional and it fires before each loop iteration to check if the loop should be exited (when the function returns true). and opaque is your user pointer, passed as-is to check_exit_cb(). no touching, no transforming, it just goes straight through 🫶

---

💖 RETURN VALUE 💖

• 0 — the interactive loop exited gracefully 🌈 all good, we're slaying
• -1 — error 😭 something went wrong

---

🌈 SEE ALSO 🌈

your required reading, bestie, go be nosy 👀✨

• ec_editline_get_el(3)
• ec_editline_set_prompt(3)
• ec_editline_complete(3)
• ec_editline_set_prompt_esc(3)
• ec_editline_parse(3)
• ec_editline_free(3)
• ec_editline_term_size(3)
• ec_editline_gets(3)
• ec_editline_set_node(3)
• ec_editline_set_history(3)
• ec_editline(3)
• ec_editline_get_node(3)
• ec_editline_curline(3)

---

💅 COPYRIGHT 💅

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

---

and that's the whole page bestie, tysm for reading 🥹💜 this was libecoli, dated 2026-06-11, page EC_EDITLINE_INTERACT(3) — go forth and interact ✨🌸🦋