make_absolute_filename(3alleg4)

✨ make_absolute_filename ✨

okay bestie, we're in the Allegro manual and this one is literally called make_absolute_filename — she takes a path and a relative filename and hands you back a whole absolute filename. Allegro game programming library energy 💖

🌸 SYNOPSIS 🌸

#include <allegro.h>

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

🦋 DESCRIPTION 🦋

So here's the vibe: you've got an absolute path, you've got a relative filename, and you want them to be one single absolute filename. That's her. That's the whole job. 💅

She stores at most size bytes into the dest buffer — so like, size is the limit, not a suggestion, don't be messy about it.

And ngl, this is basically calling replace_filename() and then canonicalize_filename() — like, that's the exact relationship. If you already know those two, you already know her. iykyk 🫶

Example, because we love a concrete moment:

char buf[256];
...
make_absolute_filename(buf, "/usr/games/",
                       "../temp.txt", sizeof(buf));
/* This would create /usr/temp.txt */

See how the .. got handled? That's the canonicalize part doing her thing. ✨

🎀 RETURN VALUE 🎀

Returns a copy of the dest parameter. That's it, that's the tea. She gives you back dest. 👑

👑 SEE ALSO 👑

• make_relative_filename(3alleg4)
• is_relative_filename(3alleg4)
• replace_filename(3alleg4)
• canonicalize_filename(3alleg4)

okay so that's the whole page, no cap, every flag and function signature preserved because we do not play fast and loose with documentation 💜

This was Allegro, version 4.4.3 — go forth and build them absolute filenames, bestie, you're gonna slay 🦋💖🌸