replace_filename(3alleg4)

💖 replace_filename — the Allegro manual, but make it cute ✨

okay bestie, welcome to Allegro's replace_filename(3alleg4) page 🌸 this one lives in the Allegro game programming library and it's literally just here to swap out the tail end of a path. no cap, it's giving "glow up your filename" energy 💅

🦋 NAME 🦋

replace_filename — Replaces path+filename with a new filename tail. Allegro game programming library. ✨

🎀 SYNOPSIS 🎀

#include <allegro.h>

char *replace_filename(char *dest, const char *path, const char
*filename, int size);

💜 DESCRIPTION 💜

so here's the tea, bestie 🍓 this function replaces the specified path+filename with a shiny new filename tail, and it stores at most size bytes into the dest buffer. iconic.

and the best part: you can use the same buffer as both input and output, because Allegro internally works on a copy of the input before it ever touches dest 🫶 so no messy self-overwrite drama. periodt.

example time, lowkey my fave part:

char name[200];
...
get_executable_name(name, sizeof(name));
replace_filename(name, name, "sound.dat", sizeof(name));

see how name shows up twice? yeah. that's the whole point. slay 💅

⭐ RETURN VALUE ⭐

Returns a copy of the dest parameter. that's it, that's the return. simple, clean, no notes 👑

🌈 SEE ALSO 🌈

• get_filename(3alleg4)
• replace_extension(3alleg4)
• append_filename(3alleg4)

💀 heads up bestie: keep that size honest — it's the max bytes written into dest, and we do not want buffer chaos. safety first, always 💖

and that's the whole page!! this was Allegro version 4.4.3, mwah 💋 go forth and replace those filenames, you absolute main character 🧚✨💜