AL_REGISTER_SAMPLE_IDENTIFIER(3)

🎀 al_register_sample_identifier(3) 🎀

okay so bestie, this page lives in the Library Functions Manual and it is giving Allegro 5 API realness. It is all about al_register_sample_identifier, and we are gonna cover every lil detail. 💖

---

💖 NAME 💖

al_register_sample_identifier — Allegro 5 API. That is the name, that is the vibe. ✨

📜 SYNOPSIS 📜

#include <allegro5/allegro_audio.h>

bool al_register_sample_identifier(const char *ext,
   bool (*identifier)(ALLEGRO_FILE* fp))

🌸 DESCRIPTION 🌸

So what it does: it registers an identify handler for al_identify_sample(3). The function you pass in gets used to detect files for the given extension. Lowkey important: it will be called with a single argument of type ALLEGRO_FILE(3), which is a file handle opened for reading and located at the first byte of the file. 🫶

Your handler should try to read as few bytes as possible to safely determine if the given file contents correspond to the type with the extension, and return true in that case, false otherwise. No cap, keep it efficient. The file handle must not be closed, but there is no need to reset it to the beginning. 💅

The extension should include the leading dot (.) character. It will be matched case-insensitively. Cute. 🎀

The identifier argument may be NULL to unregister an entry. Yes, NULL is the unregister button. 🙈

Returns true on success, false on error. Returns false if unregistering an entry that doesn’t exist. So if you are unregistering a ghost entry, you get false, bestie. 💀

⭐ SINCE ⭐

5.2.8 — iconic since then. 👑

👀 SEE ALSO 👀

• al_identify_bitmap(3) — go look at this one too, iykyk. 🦋

---

That is the whole page, bestie — straight from the Allegro reference manual 💖 and the footer has no date stamped on it, just that source/version vibe and the truncated al_registe..._identifier(3) title. periodt. ✨