ecoli_node_subset(3)

💅 ecoli_node_subset — Libecoli manual page (section 3)

okay so bestie, buckle up — this is the ecoli_node_subset(3) page from Libecoli, and honestly? it's giving chaos gremlin energy in the best way. it's a Subset node:

• A node that matches any subset of its children in any order. 🦋

like, any subset. any order. no cap. let's get into it ✨

---

✨ NAME ✨

ecoli_node_subset — the Subset node, bestie

• A node that matches any subset of its children in any order. 🎀

---

🌸 SYNOPSIS 🌸

🧚 Macros

#define EC_NODE_SUBSET(args...)   __ec_node_subset(args, EC_VA_END)

🦋 Functions

struct ec_node * ec_node_subset (const char *id)
struct ec_node * ec_node_subset_min (const char *id, unsigned int min)
int ec_node_subset_add (struct ec_node *node, struct ec_node *child)
int ec_node_subset_set_min (struct ec_node *node, unsigned int min)
unsigned int ec_node_subset_get_min (const struct ec_node *node)

---

💖 Detailed Description 💖

A node that matches any subset of its children in any order. periodt. 🔥

👑 Configuration Schema

No configuration schema. that's it, that's the vibe — nothing to configure here, iconically low maintenance 💅

---

🎀 Macro Definition Documentation 🎀

#define EC_NODE_SUBSET(args...) __ec_node_subset(args, EC_VA_END)

Create a subset node from a list of child nodes. literally just hand it your children and go 💫

A subset node matches any permutation of a subset of its children. All child nodes passed as arguments are consumed and will be freed when the subset node is freed, or immediately on error. consumed — meaning they belong to the parent now, bestie, no take-backs 🙈

Example:

EC_NODE_SUBSET("mysubset", child1, child2, child3)

Definition at line 30 of file node_subset.h. 📍

---

🌈 Function Documentation 🌈

struct ec_node* ec_node_subset (const char * id)

Create an empty subset node. empty! a blank canvas! main character energy ⭐

Use ec_node_subset_add() to add children.

Parameters

• id — The node identifier.

Returns

• The node, or NULL on error (errno is set). 😭

---

struct ec_node* ec_node_subset_min (const char * id, unsigned int min)

Create an empty subset node with a minimum number of children that must match. because sometimes zero just isn't enough, y'know? 💀

Use ec_node_subset_add() to add children.

Parameters

• id — The node identifier.
• min — The minimum number of children that must match.

Returns

• The node, or NULL on error (errno is set). 😭

---

int ec_node_subset_add (struct ec_node * node, struct ec_node * child)

Add a child to a subset node. adoption arc complete 🫶

Parameters

• node — The subset node.
• child — The child node to add. It is consumed and will be freed when the parent is freed, or immediately on error.

Returns

• 0 on success, -1 on error (errno is set).

---

int ec_node_subset_set_min (struct ec_node * node, unsigned int min)

Set the minimum number of children that must match. like setting a boundary. healthy! 💅

By default, a subset node accepts zero matching children. Use this function to require a minimum number of children to match for the parse to succeed. so yeah — the default is zero, and if you want the parse to actually demand something, this is the glow-up button ✨

Parameters

• node — The subset node.
• min — The minimum number of children that must match.

Returns

• 0 on success, -1 on error (errno is set).

---

unsigned int ec_node_subset_get_min (const struct ec_node * node)

Get the minimum number of children that must match. the reading counterpart, we love a symmetrical API 🧚

Parameters

• node — The subset node.

Returns

• The minimum number, or 0 if the node is not a subset. (yeah, if it's not a subset node you just get a lil 0, no drama) 🌸

---

🦋 Author 🦋

Generated automatically by Doxygen for Libecoli from the source code. not a human, just a very diligent robot doing its thing 🤖💜

---

ngl bestie, the whole takeaway is: subset node = matches any subset of its children in any order, children get consumed on add, default min is 0, and every single error path sets errno. slay. 🔥

and that's the page!! this was Version 0.11.3, dated Thu Apr 9 2026, brought to you by Libecoli — mwah, catch you in the next manpage, iykyk 💋🎀🫶