AL_REGISTER_AUDIO_STREAM_LOADER_F(3)

✨ NAME ✨

okay so bestie, this is the al_registe...am_loader_f(3) page from the Library Functions Manual, and the whole moment is about al_register_audio_stream_loader_f — literally the Allegro 5 API function that registers an audio stream loader. 🎀

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_audio.h>

bool al_register_audio_stream_loader_f(const char *ext,
   ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp,
      size_t buffer_count, unsigned int samples))

💖 DESCRIPTION 💖

So here’s the vibe: this registers a handler for al_load_audio_stream_f(3) and al_play_audio_stream_f(3). The function you pass in gets used to open streams from files with the extension you give it. Iconic behavior, honestly. ✨

The extension should include the leading dot (.) character — yes, the dot matters, bestie. It’s matched case-insensitively, so casing is not the drama here. 🦋

The stream_loader argument can be NULL to unregister an entry. That’s the un-register era. 💅

It returns true on success and false on error. It also returns false if you try to unregister an entry that doesn’t exist — so if that happens, it’s not being shady, it’s just giving you the facts. 😭

🦋 SEE ALSO 🦋

• al_register_audio_stream_loader(3) — go peek at this one too, bestie. 🫶

---

cute little sign-off: this page is from the Allegro reference manual — and there’s no date on the footer, so I’m not gonna invent one, periodt. 💜