al_get_fs_entry_name(3)

💅 al_get_fs_entry_name(3) — the Allegro 5 API girlies' guide

okay so bestie, you're in the Library Functions Manual section, and this little icon is from the Allegro 5 API — let's get into it ✨

---

🌸 NAME

al_get_fs_entry_name — literally the Allegro 5 API, that's the whole vibe 🎀

---

✨ SYNOPSIS

#include <allegro5/allegro.h>

const char *al_get_fs_entry_name(ALLEGRO_FS_ENTRY *e)

---

🦋 DESCRIPTION

So this one returns the entry's filename path, periodt. 💫

But here's the tea, and it's important tea: the filesystem encoding may not be known, and the conversion to UTF-8 could — in very rare cases — cause this to return an invalid path. 😭 So it is always safest to access the file over its ALLEGRO_FS_ENTRY(3) and not the path. Like, the entry is the main character here, the path is just... a vibe. 🫶

On success it returns a read only string which you must not modify or destroy. 🚫✂️ Do not touch, do not free, do not redecorate. Returns NULL on failure. 💀

Note: prior to 5.1.5 it was written: "... the path will not be an absolute path if the entry wasn't created from an absolute path". This is no longer true. 📜✨ (history lesson over, slay)

---

🌈 SEE ALSO

ngl there's no SEE ALSO section on this page, but ALLEGRO_FS_ENTRY(3) is the icon you actually want to be hanging out with 💖

---

and that's the whole page bestie! 🎀 this cutie came to you straight from the Allegro reference manual, repping al_get_fs_entry_name(3) — go forth and access your files through the entry, not the path, iykyk 💅🔥