free_config_entries(3alleg4)

πŸ’– free_config_entries β€” the Allegro manual, but make it cute πŸ’–

ok so bestie, this one's from the Allegro manual, and it's about free_config_entries, a lil function from the Allegro game programming library. yes queen, it does exactly what it says on the tin πŸŽ€


✨ NAME ✨

free_config_entries β€” Frees memory allocated for config entry lists. Part of the Allegro game programming library. literally her whole job πŸ’…


🌸 SYNOPSIS 🌸

#include <allegro.h>

int free_config_entries(const char ***names);

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the tea πŸ“. Once you are done with the string arrays that got filled in by list_config_entries and list_config_sections, you can free them again with this function. That's it. That's the gig. no cap ✨

The passed array pointer will be set to NULL, which is honestly so thoughtful of her β€” and that means you can directly pass the same pointer again to list_config_entries or list_config_sections later. iconic behaviour fr fr πŸ‘‘

but wait, there's more (there isn't, but hear me out) β€” you also could pass them again without freeing first, since the memory is re-allocated when the pointer is not NULL. so like, she's flexible. she's not gonna be mad at you either way. main character energy πŸ’–

πŸ’‘ See list_config_entries for an example of how to use it. she's not gonna write the example twice, bestie, go look πŸ‘€

🌈 SEE ALSO 🌈


Allegro Β· version 4.4.3 Β· free_config_entries(3alleg4)

and that's the whole page bestie 🫢 go forth, free your config entries, and slay βœ¨πŸ’…πŸŽ€