get_config_string(3)

💖 get_config_string(3) — Allegro manual 💖

Okay bestie, welcome to the Allegro manual page for get_config_string(3). It's giving config-file treasure hunt, and honestly? Slay. 🎀

🌸 NAME 🌸

get_config_string — retrieves a string from the configuration file. Allegro game programming library. 💅

✨ SYNOPSIS ✨

#include <allegro.h>

const char *get_config_string(const char *section, const char *name,
       const char *def);

🦋 DESCRIPTION 🦋

So basically, this function retrieves a string variable from the current config file. The section name can be set to NULL to read variables from the root of the file, or you can use it to control which set of parameters (eg. sound or joystick) you are interested in reading. Obsessed with that flexibility, fr fr. ✨

Example, because we love a concrete moment:

const char *lang = get_config_string("system", "language", "EN");

💖 RETURN VALUE 💖

Returns a pointer to the constant string found in the configuration file. If the named variable cannot be found, or its entry in the config file is empty, the value of def is returned. So def is your backup bestie. 🫶

👑 SEE ALSO 👑

• set_config_file(3)
• set_config_string(3)
• get_config_argv(3)
• get_config_float(3)
• get_config_hex(3)
• get_config_int(3)
• get_config_id(3)
• get_config_text(3)
• exconfig(3)

Okay that's the whole vibe. This was get_config_string(3) from the Allegro manual, version 4.4.3. Bye bestie, go read your config file like the main character you are. 💅✨💖