al_get_fs_entry_name(3alleg5)

✨ NAME ✨

al_get_fs_entry_name — Allegro 5 API. okay bestie, this is the manual page for al_get_fs_entry_name(3alleg5), and she's here to hand you an entry's filename path. 💅

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

const char *al_get_fs_entry_name(ALLEGRO_FS_ENTRY *e)

🌸 DESCRIPTION 🌸

so basically, this function returns the entry's filename path. That's the whole assignment. ✨

lowkey important: 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's always safest to access the file over its ALLEGRO_FS_ENTRY(3alleg5) and not the path. Periodt. 💀

On success, it returns a read only string which you must not modify or destroy. On failure, it returns NULL. No cap. 😭

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. 🙈

From the Allegro reference manual, page al_get_fs_entry_name(3alleg5) — that's the footer, bestie. 🫶