al_get_path_filename(3alleg5)

💖 NAME 💖

al_get_path_filename — straight out of the Allegro 5 API, and she's the one who tells you the filename part of a path. No cap. 🎀

---

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

const char *al_get_path_filename(const ALLEGRO_PATH *path)

---

✨ DESCRIPTION ✨

Okay so bestie, here's the whole thing: you give her a path, she hands you back the filename part of the path. That's the job. That's the entire job. 🫶

And if there is none? You don't get a NULL, you don't get drama, you get the empty string. A little "". She's polite like that. 💅

😭 BUT WAIT. The returned pointer is valid only until the filename part of the path is modified in any way, or until the path is destroyed. Those are the two rules, and they are not vibes-based, they are real. So do NOT go holding onto that pointer like it's your emotional support string. Touch the filename part of the path, or let the path get destroyed, and that pointer is done. 💀 That's not a warning, that's a promise.

Lowkey the move is: use it right away, or copy it out yourself. Do not be the person who stores it and finds out later. 🙈

---

🌈 SEE ALSO 🌈

• al_get_path_basename(3alleg5)
• al_get_path_extension(3alleg5)
• al_get_path_component(3alleg5)

---

And that's the page, bestie. Sourced from the Allegro reference manual — no date on this one, she's simply timeless ✨ — and the page itself is al_get_path_filename(3alleg5). Go forth and get those filenames. 💜🌸