EC_CONFIG_LIST_FIRST(3)

✨ EC_CONFIG_LIST_FIRST ✨

okay bestie, welcome to the Libecoli Programmer's Manual 💖 this one's a lil function from ecoli/config.h and it's lowkey the key to unlocking list configs, no cap.

---

🌸 NAME 🌸

ec_config_list_first — grab the very first element of a list. like the opening act. the first slice. the main character of the list 🎀

---

🦋 SYNOPSIS 🦋

#include <ecoli/config.h>

struct ec_config * ec_config_list_first(
    struct ec_config   *list   /* The list configuration to iterate. */
);

see that list param? that's the list configuration to iterate — that's the whole vibe, you're looping through it 💅

---

🌈 DESCRIPTION 🌈

so here's how you actually use it, fr fr — example of use:

for (config = ec_config_list_first(list);
 config != NULL;
 config = ec_config_list_next(list, config)) {
    ...
}

like, you start with ec_config_list_first(list), you keep going while config != NULL, and you step forward with ec_config_list_next(list, config). it's giving for-loop perfection. periodt. 👑

---

🎀 STRUCTURES 🎀

this is the structure storing the configuration data. iconic container energy:

struct ec_config {
    union ec_config::@165033305204240054252215261010262276266146032272  @204272232073016241350260013126061051223010235320;
};

(yeah bestie that union name is WILD but we copy it exactly, we don't question the elders 🙈)

---

💜 RETURN VALUE 💜

it hands you back the first configuration element ✨ … OR NULL on error (and errno is set). so if you get NULL, check errno, that's your hint bestie 😭

---

💀 SEE ALSO 💀

the whole squad, go read these too:

• ec_config_schema_sub(3)
• ec_config_u64(3)
• ec_config_list_del(3)
• ec_config_dict(3)
• ec_config_count(3)
• ec_config_schema_dump(3)
• ec_config_i64(3)
• ec_config_list_next(3)
• ec_config_get_type(3)
• ec_config_dict_set(3)
• ec_config_schema_type(3)
• ec_config_node(3)
• ec_config_list(3)
• ec_config_cmp(3)
• ec_node_config_node_list_to_table(3)
• ec_config_key_is_reserved(3)
• ec_config_string(3)
• ec_config_dict_get(3)
• ec_config_free(3)
• ec_node_config_node_list_from_vargs(3)
• ec_config_list_add(3)
• ec_config_schema_validate(3)
• ec_config_schema_lookup(3)
• ec_config_validate(3)
• ec_config_dup(3)
• ec_config_dump(3)
• ec_config_dict_del(3)
• ec_config_bool(3)

---

👑 COPYRIGHT 👑

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

---

and that's the whole page, bestie!! this was libecoli, dated 2026-06-11, all about EC_CONFIG_LIST_FIRST(3) — slay, go iterate some lists, ily 🫶✨