al_join_paths(3alleg5)

💖 NAME 💖

hey bestie, welcome to the al_join_paths(3alleg5) page from the Allegro reference manual! This one is all about al_join_paths — Allegro 5 API, and it's lowkey iconic for path girlypops.

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

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

---

🦋 DESCRIPTION 🦋

okay so picture two path structs, and we're gonna concatenate them. The first path structure, path, gets modified. She's the main character and she's changing in place, periodt.

If tail is an absolute path, this function does nothing. Like, absolutely nothing, no cap. It just sits there looking pretty.

If tail is a relative path, then all of its directory components get appended to path. Also, tail’s filename will overwrite path’s filename — even if it is just the empty string. Yes bestie, even "" is out here overwriting things. 💅

Tail’s drive is ignored. Not invited to the function, not on the guest list, bye. 🙈

It returns true if tail was a relative path and so concatenated to path; otherwise it returns false. So like, a little bool vibe check for you.

---

👑 SEE ALSO 👑

• al_rebase_path(3alleg5)

---

xoxo, signing off from the Allegro reference manual — al_join_paths(3alleg5) — and the footer didn't give me a date, so that's all she wrote 🎀💖