load_wav(3alleg4)

✨ NAME ✨

load_wav — bestie, this is the one that loads a sample from a RIFF WAV file 💖 and yeah it's part of the Allegro game programming library, so we're in 3alleg4 territory, iykyk ✨

🌸 SYNOPSIS 🌸

#include <allegro.h>

SAMPLE *load_wav(const char *filename);

💅 DESCRIPTION 💅

Okay so, load_wav loads a sample from a RIFF WAV file. That's it, that's the whole vibe. You hand it a filename, it hands you a SAMPLE, main character energy all around 🎀

Like, for example, look at this iconic little snippet:

SAMPLE *sample = load_wav("scream.wav");
if (!sample)
   abort_on_error("Couldn't scare user!");

Not us loading "scream.wav" and then bailing with abort_on_error("Couldn't scare user!") if it didn't work 😭 peak comedy, peak engineering, no notes 💀

🦋 RETURN VALUE 🦋

It returns a pointer to the SAMPLE — slay — or NULL if something went wrong 😭 (error vibes only).

Real talk though: remember to free this sample later, because otherwise you get memory leaks and that's not the aesthetic, bestie 🫶 leaks are giving unhandled baggage and we don't do that here.

👑 SEE ALSO 👑

• load_sample(3alleg4) — the other sample-loading girlie 💜
• register_sample_file_type(3alleg4) — for when you wanna teach Allegro new file type tricks ✨

That's the whole page, fr fr. This came to you from the Allegro manual, version 4.4.3 🎀 mwah, go make something loud 💖🎧