EC_NODE_CLONE(3)

💖 EC_NODE_CLONE — okay bestie, let's clone a node 💖

Libecoli Programmer's Manual · ec_node_clone(3) · come sit with me, this one's short and it's iconic 🦋

---

✨ NAME ✨

ec_node_clone — clone a grammar node. that's it. that's the whole job. 💅

---

✨ SYNOPSIS ✨

#include <ecoli/node.h>

struct ec_node * ec_node_clone(
    struct ec_node   *node   /* The node to clone. */
);

look at that signature. clean. no notes. 🎀

---

✨ DESCRIPTION ✨

okay so real talk, this is not the deep-copy situation you might be picturing. ec_node_clone just takes a reference to the node. that's the move. that's the whole move. ✨

the way that works is: if you later call ec_node_free() on this node, it only decreases the reference. the actual free doesn't happen until the reference count hits 0. and the reference counter? it's initialized to 1 at node creation. 🫶

so like, refcounting. it's giving shared ownership. slay.

---

✨ RETURN VALUE ✨

• the pointer to the cloned node — and no cap, it's always equal to the parameter 🌈
• it returns NULL if the parameter was NULL — and in that case, nothing is done 🙈

---

✨ SEE ALSO ✨

the whole squad, fr fr 👑 — go read these too:

• ec_node_check_type(3)
• ec_node_iter(3)
• ec_node_attrs(3)
• ec_node_find(3)
• ec_node_type_name(3)
• ec_node_free(3)
• ec_node_id(3)
• ec_node_type_dump(3)
• ec_node_get_config(3)
• ec_node_schema_dump(3)
• ec_node_priv(3)
• ec_node_type_lookup(3)
• ec_node_dump(3)
• ec_node_desc(3)
• ec_node_iter_free(3)
• ec_node_iter_get_parent(3)
• ec_node_from_type(3)
• ec_node_type(3)
• ec_node_iter_next(3)
• ec_node_type_schema(3)
• ec_node(3)
• ec_node_get_children_count(3)
• ec_node_get_type_name(3)
• ec_node_type_register(3)
• ec_node_set_config(3)
• ec_node_iter_get_node(3)
• ec_node_get_child(3)

---

✨ COPYRIGHT ✨

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

---

and that's the page!! this was libecoli, dated 2026-06-11, filed under EC_NODE_CLONE(3) — tysm for reading, bestie, go refcount responsibly 🧚💖🌸