EC_COMP_GET_CUR_PSTATE(3)

💖 EC_COMP_GET_CUR_PSTATE — bestie's guide to the current pstate 💖

okay so real talk, this is a page from the Libecoli Programmer's Manual, and it's about one (1) little function that goes hard: ec_comp_get_cur_pstate. ✨

---

🌸 NAME 🌸

ec_comp_get_cur_pstate — get the current parsing state of completion. literally that's the whole gig. 💅

---

🎀 SYNOPSIS 🎀

#include <ecoli/complete.h>

struct ec_pnode * ec_comp_get_cur_pstate(
    const struct ec_comp   *comp   /* The current completion list. */
);

so you include <ecoli/complete.h> and you call it with comp, which is the current completion list. that's the tea. 🫶

---

🦋 DESCRIPTION 🦋

bestie, listen. this function is designed to be called by a node during the completion process. like, mid-glow-up. 💫

here's the vibe: when the library is processing the list of completions for a given input, it builds an incomplete parsing tree before the completion callback even gets invoked. and a node can absolutely use that tree if the completions list depends on what was previously parsed. iykyk. 🌈

the iconic example? the ec_node_once() node. it peeks inside the parsing tree to check if the node is already parsed, and if it is — no completion is issued. periodt. 👑

---

✨ RETURN VALUE ✨

the current parsing state. and it cannot be NULL — so don't even stress about a null check, it's giving reliable. 💖

---

👑 SEE ALSO 👑

the whole friend group, no cap:

• ec_comp_add_item(3)
• 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_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 a wrap on the EC_COMP_GET_CUR_PSTATE(3) page from libecoli, dated 2026-06-11 — mwah, slay, go parse something gorgeous. 💅✨🎀🦋