al_join_paths(3)

✨ al_join_paths(3) ✨

okay so bestie, welcome to the Allegro 5 API page for al_join_paths 💅 this one's a path-gluing icon and she's about to make your two path structs hold hands 🫶

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

bool al_join_paths(ALLEGRO_PATH *path, const ALLEGRO_PATH *tail)

---

💖 DESCRIPTION 💖

So what she does is concatenate two path structures ✨ and the first path structure is the one that gets modified — she's the main character here, tail is just visiting 💁‍♀️

If tail is an absolute path, this function literally does nothing. like, nothing nothing. no cap, she just sits there 🙈

If tail is a relative path, then all of its directory components get appended to path. and bestie, listen — tail's filename will also overwrite path's filename, even if it is just the empty string 😭 so yes, empty string counts, she will absolutely clobber it fr fr

Tail's drive is ignored. 🚗💨 don't ask, it's just not invited to the party

She returns true if tail was a relative path and so got concatenated onto path, otherwise she returns false 🎀

lowkey important vibe check: absolute tail = no changes at all, so don't be surprised when your path comes back looking identical 💀

---

🦋 SEE ALSO 🦋

• al_rebase_path(3) — her sibling, go say hi 👑

---

✨ that's the whole page, slay ✨ this was the Allegro reference manual entry for al_join_paths(3), brought to you by the Allegro reference manual, bestie 🎀 💜