reload_config_texts(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

💖 reload_config_texts(3) — Allegro manual 💖

okay bestie, sit down, we're talking about reload_config_texts from the Allegro game programming library, and honestly? it's giving language-switcher realness. 🦋

✨ SYNOPSIS ✨

#include <allegro.h>

void reload_config_texts(const char *new_language);

🌸 DESCRIPTION 🌸

so what this does: it reloads the translated strings that get_config_text() handed you. which is so useful when you wanna switch to another language inside your program at runtime — like, mid-game, no relaunch, no drama. 💅

now, the deets, and listen carefully bc there's choices:

  • If you wanna modify the [system] language configuration variable yourself, or you've switched configuration files, then you're gonna wanna pass NULL — that just reloads whatever language is currently selected. no fuss. 🙈
  • Or, you can pass a string containing the two letter code of the language you desire to switch to, and the function will modify the language variable for you. queen behavior, honestly. 👑
⚠️ okay this part is IMPORTANT, no cap: after you call this function, the previously returned pointers of get_config_text() will be invalid. like, they're gone. don't touch them. it's giving dangling pointer energy and we do NOT play with that. 💀

Example time, because we love a demonstration:

...
/* The user selects French from a language choice menu. */
reload_config_texts("FR");

see? the user picks French from a language choice menu, and boom, reload_config_texts("FR") does the thing. iconic. 🌈

👀 SEE ALSO 👀

and that's the whole page, bestie!! this is Allegro version 4.4.3, and yeah, reload_config_texts(3) really said "i contain multitudes (of languages)." go forth and localize, you main character. 🎀✨🫶

📦 where this page comes from