SHTK_CONFIG_LOAD(3)

🌸 SHTK_CONFIG_LOAD(3) 🌸

okay bestie, manual name check: this page lives in the Library Functions Manual, and it's giving "tiny but important config-loading icon" 💅✨

---

✨ NAME ✨

shtk_config_load — loads up a configuration file, periodt 💖

🌈 LIBRARY 🌈

shtk_import config — that's the import line, iykyk 🫶

🎀 SYNOPSIS 🎀

shtk_config_load config_file

🦋 DESCRIPTION 🦋

okay so shtk_config_load parses and loads the configuration file you hand it as config_file 💫

The way this works: only the configuration variables you already registered as valid — by calling shtk_config_init(3) — get recognized as valid during the load. Any variables that the configuration file defines but that are not registered in the shtk_config_load module get ignored during the load 🙈 no cap.

🌸 EXAMPLES 🌸

Picture this configuration file, iconic:

prefix=/usr
OBJDIR="${prefix}/obj"
SRCDIR="${prefix}/src"

And here's the little code snippet that shows how to load and display the settings from that file above:

shtk_config_init OBJDIR SRCDIR
shtk_config_load ".../path/to/the/file/above.conf"

echo "prefix was defined but is not available:" \
    "$(shtk_config_get_default prefix default-value)"
echo "OBJDIR is $(shtk_config_get OBJDIR)"
echo "SRCDIR is $(shtk_config_get SRCDIR)"

💀 ERRORS 💀

⚠️ if something errors out while config_file is being processed, the caller script gets terminated. literally done. 😭

👑 SEE ALSO 👑

• shtk(3)
• shtk_config(3)

⭐ HISTORY ⭐

shtk_config_load first appeared in shtk 1.0 ✨ iconic behavior.

---

okay that's the page! source/version: Debian, date: November 6, 2014 — mwah 💖🎀