append_filename(3alleg4)

✨ append_filename — bestie edition ✨

okay so this is a page from the Allegro manual (yes, the game programming library, she's iconic, she's 4.4.3, she's been holding down the fort since forever 💖). Buckle up, we're gluing filenames together.

🌸 NAME 🌸

append_filename — literally just concatenates a filename onto a path. That's it. That's the whole job. Allegro game programming library core behaviour, no cap.

🎀 SYNOPSIS 🎀

#include <allegro.h>

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

💅 DESCRIPTION 💅

okay so picture this: you have a path, you have a filename, and you want them to be one thing. That's the vibe. append_filename takes the filename you specified and concatenates it onto the end of the path you specified, and it stores at most size bytes into the dest buffer. at most, bestie. size is the limit. respect the limit. 🫶

and here's the little detail that's giving thoughtful: if path doesn't already have a trailing path separator, the function will append one if needed. so it's not out here making ugly "/home/userprog.bin" messes. she ate. 🔥

also — and this is the part that lowkey makes her a queen — you can use the same buffer both as input and output. why? because Allegro internally works on a copy of the input before it touches dest. so like, no self-sabotage, no weird aliasing drama, no 😭. she made a copy first, she's careful, she's main character energy.

here's the example from the page, verbatim, don't @ me:

append_filename(buf, "/home/user",
                "prog.bin", sizeof(buf));

see how chill that is? buf in, buf out. no notes. ⭐

👑 RETURN VALUE 👑

returns a copy of the dest parameter. that's it, that's the tea. ☕

🦋 SEE ALSO 🦋

• replace_filename(3alleg4) — for when you don't wanna append, you wanna swap. different energy, same friend group.

💀 quick vibe check: this page is short because the function is short. don't go looking for hidden options, there are none. the whole page is right here. periodt.

that's the whole page, bestie, we got through it together 🌈✨ this was Allegro, version 4.4.3, and the manual page is append_filename(3alleg4) — mwah, ily, go build something cute 💜🎀