EC_PNODE_...RST_CHILD(3)

💖 EC_PNODE_...RST_CHILD 💖

okay bestie, welcome to the Libecoli Programmer's Manual — yes, that's the manual name, no I will not stop saying it. this one's short and sweet and honestly kinda iconic for it. it's all about grabbing the first child of a node in the parsing tree. that's the whole vibe. let's go 🦋

---

✨ NAME ✨

ec_pnode_get_first_child — Get the first child of a node in the parsing tree.

like. it gets the first child. of a node. in the parsing tree. no cap, that's the job 💅

---

🌸 SYNOPSIS 🌸

#include <ecoli/parse.h>

struct ec_pnode * ec_pnode_get_first_child(
    const struct ec_pnode   *pnode   /* A node in the parsing tree. */
);

so you pull in <ecoli/parse.h> and then you hand it a pnode — which is, and I quote the comment exactly, A node in the parsing tree. — and it gives you back a pointer to a struct ec_pnode. that's it. that's the whole function signature. so clean, so minimal, we love a low-maintenance queen 👑

---

🎀 RETURN VALUE 🎀

The first child node, or NULL if it has no child.

that's the tea ☕ — you get the first child back, and if this node is giving only-child-with-no-children energy (aka it literally has no child), you get NULL. always check for that NULL bestie, it WILL humble you 😭

---

🌈 SEE ALSO 🌈

the whole friend group fr fr, all the siblings and cousins of this function:

• ec_pnode_len(3)
• ec_pnode_get_strvec(3)
• ec_parse(3)
• ec_parse_strvec(3)
• ec_pnode(3)
• ec_pnode_free_children(3)
• ec_pnode_get_root(3)
• ec_pnode_get_parent(3)
• ec_pnode_find_next(3)
• ec_pnode_free(3)
• ec_pnode_dup(3)
• ec_pnode_matches(3)
• ec_pnode_dump(3)
• ec_pnode_unlink_child(3)
• ec_pnode_next(3)
• ec_pnode_del_last_child(3)
• ec_pnode_link_child(3)
• ec_pnode_count(3)
• ec_pnode_get_attrs(3)
• ec_pnode_get_last_child(3)
• ec_pnode_get_node(3)
• ec_pnode_find(3)
• ec_parse_child(3)

go read them all, they ate 🔥

---

👑 COPYRIGHT 👑

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

---

and that's the whole page, bestie, you're officially caught up 🫶 stay hydrated, check your NULLs, and remember: every parsing tree has a first child, and now you know how to find it. periodt 💜

libecoli · 2026-06-11 · EC_PNODE_...RST_CHILD(3) — mwah, signing off, ily, go write some C 💅✨