al_seek_audio_stream_secs(3alleg5)

✨ al_seek_audio_stream_secs ✨

okay bestie, welcome to the Allegro 5 API corner of the man pages (yes that's the 3alleg5 manual, we're fancy like that 💅). this one's short and sweet but it's SO useful, trust.

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_audio.h>

bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)

like look at that signature. clean. iconic. no notes. 🫶

---

💖 DESCRIPTION 💖

so what does it do? it sets the streaming file playing position to time. that's it, that's the whole vibe — you're basically dragging the little scrubber bar on your audio, but in code. ⏩

it returns true on success. returns false... well, you know. 🙈

⚠️ real talk though: right now this can only be called on streams that were created with one of these four: - al_load_audio_stream(3alleg5) - al_play_audio_stream(3alleg5) - al_load_audio_stream_f(3alleg5) - al_play_audio_stream_f(3alleg5) call it on anything else and it's giving not it. so make sure your stream came from one of those before you go seeking, bestie. 💀

---

🦋 SEE ALSO 🦋

• al_get_audio_stream_position_secs(3alleg5) — for when you wanna know where you're at 👀
• al_get_audio_stream_length_secs(3alleg5) — for when you wanna know how much song is left 😭

---

and that's the whole page, no cap. this was the Allegro reference manual entry for al_seek_audio_stream_secs in the 3alleg5 manual — go forth and seek responsibly, mwah 💋🎀