set_config_file(3alleg4)

💖 set_config_file 💖

okay bestie, welcome to set_config_file from the 3alleg4 manual — aka the Allegro game programming library, and yes this whole page is about picking which config file the rest of the library is gonna read from. it's giving "you get ONE config file and it's this one". 🌸

✨ NAME ✨

set_config_file — sets the configuration file. part of the Allegro game programming library. that's the whole job, and she does it flawlessly. 💅

✨ SYNOPSIS ✨

#include <allegro.h>

void set_config_file(const char *filename);

so you include <allegro.h> up top like always, and then it's literally just void set_config_file(const char *filename); — one argument, returns nothing, zero drama. 🎀

✨ DESCRIPTION ✨

okay so here's the tea: this function sets the configuration file that all the subsequent config functions are gonna use. like, from this moment forward, that's the file. periodt. 🫶

and important: Allegro will not go hunting for this file in other locations the way it does with allegro.cfg at the time of initialization. nope. you told her where the file is, she's gonna trust you on that. no vibe check, no searching, no backup plan. 🙈

🚨 bestie, MAJOR warning: all pointers returned by previous calls to get_config_string() and other related functions are invalidated when you call this function! like, every single one. if you were holding onto a pointer from before, it is now dust. gone. deceased. don't touch it. 😭

and here's the scheduling lore you need: you can call this function before install_allegro() if you wanna change the configuration file early, but if you wanna use a text encoding format that isn't the default, you've gotta call it after set_uformat(). order matters, queen. do it wrong and the encoding said nope. ✨

✨ SEE ALSO ✨

if this page ate and you want more, go read her friends:

• set_config_data(3alleg4)
• override_config_file(3alleg4)
• push_config_state(3alleg4)
• set_uformat(3alleg4)
• set_config_string(3alleg4)
• get_config_string(3alleg4)
• exconfig(3alleg4)

and that's the page, bestie!! 🌈 this was set_config_file from Allegro, version 4.4.3 — mwah, iconic, no cap. go set that config file and slay. 👑💖🦋