replace_extension(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

💅 replace_extension(3) — the Allegro manual, but make it cute

okay bestie, so this one lives in the Allegro game programming library and it's literally called replace_extension. Yes, it does exactly what it says on the tin: it takes a filename+extension and swaps the extension tail for a new one. No cap. 🎀

✨ NAME ✨

replace_extension — swaps out a filename+extension for a brand new extension tail. Part of the Allegro game programming library. 💖

🌸 SYNOPSIS 🌸

#include <allegro.h>

char *replace_extension(char *dest, const char *filename, const char *ext, int size);

🦋 DESCRIPTION 🦋

So here's the vibe: you hand it a filename (extension and all), and it replaces that extension with the new ext tail you want, writing the result into the dest buffer. It stores at most size bytes in there, so don't get bold with the buffer, bestie. 💀

Now the fun part — if the filename has no extension at all, it just appends ext to the end of it, and it'll add a dot character if that's needed. Thoughtful. Iconic. 💅

And here's the part that makes me feral: you can use the same buffer for both input and output, because Allegro internally works on a copy of the input before it ever touches dest. Go off, honestly. 🔥

Example, look:

replace_extension(buf, "C:\\game\\prog.exe",
                  "dat", sizeof(buf));

see how it's giving "prog.exe → prog.dat" energy? obsessed. ✨

👑 RETURN VALUE 👑

It returns a copy of the dest parameter. That's it, that's the tea. 🫶

🌈 SEE ALSO 🌈

k bye bestie, go forth and rename things responsibly 💖✨🎀🦋🌸💅🫶

this has been your girl repping Allegro, version 4.4.3 — mwah, periodt. 💜🧚⭐

📦 where this page comes from