set_config_file(3)

💖 set_config_file(3) 💖

okay bestie, welcome to the Allegro manual — yes, that Allegro, the game programming library, and today's main character is set_config_file. she's short, she's powerful, and she will absolutely invalidate your pointers, no cap. 🎀

✨ NAME ✨

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

🌸 SYNOPSIS 🌸

#include <allegro.h>

void set_config_file(const char *filename);

🦋 DESCRIPTION 🦋

so basically, this function sets the configuration file that every single config function after it is gonna use. like, once you call her, all the subsequent config stuff is looking at your file. and here's a lil detail the manpage wants you to know fr fr: Allegro will not go hunting around other locations for this file the way it does with allegro.cfg at the time of initialization. so if you give her a path, that's the path. periodt. 📍

⚠️ MAJOR WARNING BESTIE: all pointers returned by previous calls to get_config_string() and other related functions are invalidated when you call this function! like, gone. dust. do not touch them after this. 😭💀

also, a lil scheduling note for your setup order — you can call this function before install_allegro() to change the configuration file, but you should call it after set_uformat() if you want to use a text encoding format other than the default. the way that order actually matters… 👑✨

🌈 SEE ALSO 🌈

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

go read those too, they're all part of the same lil config friend group 🫶

and that's the whole page!! this was Allegro version 4.4.3, and yes, that's the version and the source right there in the sign-off, so you know exactly which Allegro you're vibing with. mwah, love you, go set your config file 💜🍓🧚