al_identify_sample(3alleg5)

💖 al_identify_sample — Allegro 5 API 💖

okay bestie, so this one is from the Allegro 5 API (that's the 3alleg5 manual, iykyk) and it's literally the cutest little detective function. it looks at a file and is like "hmm what ARE you" 🕵️♀️✨

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_audio.h>

char const *al_identify_sample(char const *filename)

---

✨ DESCRIPTION ✨

so this does exactly the same thing as al_identify_sample_f(3alleg5) — same energy, same slay — but the difference is you hand it the filename of the file you want it to figure out, instead of a file handle. that's it, that's the whole vibe. 🎀

and here's the part that lowkey trips people up: the extension, if there even is one, of the filename you pass in? not taken into account at all. like, zero. none. it does not care that you named it .wav or .mp3 or definitely_a_song.xyz. it only looks at the actual contents of the file. main character behavior honestly — it judges you by who you are on the inside, not by your file extension. 💅

---

🦋 SINCE 🦋

5.2.8 — so it's been around a minute, it's not new new. ✨

---

🫶 SEE ALSO 🫶

• al_init_acodec_addon(3alleg5) — you're gonna need the codec addon initialized bestie, don't skip this one
• al_identify_sample_f(3alleg5) — the sibling function, same thing but with a file handle
• al_register_sample_identifier(3alleg5) — the way you teach Allegro how to recognize more types

---

ok real talk, if it can't figure out the type it's gonna give you back a null pointer situation, so vibe check your return value before you go using it, k? 🙈

---

and that's the whole page!! Allegro reference manual, bestie — al_identify_sample(3alleg5), no cap. go identify some samples, you got this 👑💖