wofi-config(3)

💖 wofi-config(3) 💖

okay bestie, welcome to the wofi-config(3) page from the Library Functions Manual — yes it's a manual page, no it's not boring, sit down, we're learning config functions together 🫶

✨ NAME ✨

wofi — Config functions and documentation 💅

🌸 DESCRIPTION 🌸

so like, the functions we're about to talk about? they're the ones you use to mess with maps that represent config entries. that's the whole vibe. they live in config.h — no cap, that's where they're defined. 🎀

👑 CONFIG FUNCTIONS 👑

these are the functions you use to work with configs, and we're going through all of them, no skipping, periodt. 💜

• void config_put(struct map* map, char* line) — parses a single config line and inserts the result into the map ✨
  • struct map* map — the map you're inserting into, bestie.
  • char* line — the config line you're inserting. it should be in the format of key=value, okay? that's the format. iykyk. 💫
• void config_load(struct map* map, const char* config) — loads a config file into the given map 🌈
  • struct map* map — the map to load the config into.
  • const char* config — the path to a config file. it should contain lines with the format of key=value. 🍓
• char* config_get(struct map* config, const char* key, char* def_opt) — gets a config entry, and if the entry is not set then it returns def_opt. iconic behaviour honestly. 👑
  • struct map* config — the map to get the value from.
  • const char* key — the key to look up 🔍
  • char* def_opt — the default value to be returned if the key does not exist. your little safety net, we love her. 🫶
• int config_get_mnemonic(struct map* config, const char* key, char* def_opt, int num_choices, ...) — gets an enum value from the config. if the value is not set then it returns def_opt. ✨
  • struct map* config — the map to get the value from.
  • const char* key — the key to look up 🔍
  • char* def_opt — the default value to be returned if the key does not exist.
  • int num_choices — the number of enum options available, count them carefully bestie 🔢
  • varargs — the list of enum options available. yes, varargs. the little ... is doing a lot of work here and we respect it. 💅

and that's the whole page!! every function, every parameter, every default — nothing got left behind, fr fr. 🦋

mwah 💋 — sent to you straight from the wofi-config(3) manual page, that's the source and the version, bestie. go slay some configs. 💖✨🎀