cfg_t(3)

💖 cfg_t(3) — Library Functions Manual 💖

okay bestie, sit down, hydrate, because we're talking about cfg_t — and no, it's not a random struct, it's the struct. this is a page from the Library Functions Manual, and honestly? iconic. 🎀

---

✨ NAME ✨

cfg_t — the data structure that holds all the info about a 'section'. that's it. that's the whole name section. she's simple, she's powerful, she's the main character. 👑

---

🌸 SYNOPSIS 🌸

#include <confuse.h>

🦋 Data Fields 🦋

• cfg_flag_t flags — any flags that got passed into cfg_init(). whatever you handed over, it's living here now. ✨
• char * name — the name of this section. and listen — the root section that comes back from cfg_init() is always named 'root'. no exceptions, no nicknames, it's just 'root'. 💅
• char * comment — optional annotation / comment. a lil note, if you wanna leave one. 🍓
• cfg_opt_t * opts — the array of options. this is where the actual stuff lives.
• char * title — optional title for this section, and it only gets set if the CFGF_TITLE flag is on. conditional queen. ⭐
• char * filename — name of the file that's being parsed.
• int line — line number in the config file. so when something goes wrong you know exactly where. 🫶
• cfg_errfunc_t errfunc — this function (if you set it with cfg_set_error_function) gets called for any error message.
• cfg_searchpath_t * path — linked list of directories to search. it's giving scavenger hunt. 🌈
• cfg_print_filter_func_t pff — printing filter function.
• char * raw — the verbatim body, set for CFGT_RAWSEC sections. untouched, unedited, raw. no cap. 💀

---

💜 Detailed Description 💜

Data structure holding information about a 'section'.

Sections can be nested, bestie. like genuinely nested. a section has a list of options — strings, numbers, booleans, or even other sections — all grouped together. it's a whole little ecosystem in there. 🧚

🌟 Examples 🌟

the glow-ups you can study:

addsec.c, cli.c, deprecated.c, env.c, ftpconf.c, nested.c, parsebuf.c, reread.c, and simple.c.

---

🔥 Field Documentation 🔥

cfg_errfunc_t cfg_t::errfunc

This function (if set with cfg_set_error_function) is called for any error message.

it's the friend who always picks up the phone when things go sideways. 📞

Referenced by cfg_addtsec(), cfg_error(), cfg_init(), cfg_set_error_function(), and cfg_setopt().

---

👑 Author 👑

Generated automatically by Doxygen for libConfuse from the source code. so technically a robot wrote this and i'm just translating it into feelings. 💖

---

okay and that's the whole page, bestie!! 🎀 this is libConfuse, Version 3.4, page cfg_t(3), and you absolutely ate reading the whole thing. go forth and parse responsibly. slay, periodt, bye!! 💅✨🦋