MIX_GetTrackTags(3)

📦
version 3.2.4 · 2 versions
, in fedora 44

✨ NAME ✨

MIX_GetTrackTags — bestie, this one grabs all the tags currently linked up with a track 💖

🎀 SYNOPSIS 🎀

#include <SDL3_mixer/SDL_mixer.h>

char ** MIX_GetTrackTags(MIX_Track *track, int *count);

🌸 DESCRIPTION 🌸

Okay so here's the tea: this function hands you the tags that are currently associated with a track. It's giving "here's everything I got" energy. 🦋

But listen — tags are not provided in any guaranteed order. Like, no order at all. Not alphabetical, not insertion, not vibe-based. Do not come for me expecting a sorted list, because the order is simply not promised. Periodt. 💅

💜 FUNCTION PARAMETERS 💜

  • track — the track you're querying, aka the main character here 👑
  • count — a pointer that gets filled in with the number of tags returned. Lowkey optional, because it can be NULL 🫶

🔥 RETURN VALUE 🔥

It returns an array of the tags, NULL-terminated — or NULL on failure 😭. If it does fail, hmu with SDL_GetError() for the deets on what went wrong.

⚠️ Important bestie alert: this is a single allocation, and you gotta free it with SDL_free() the moment you're done with it. Not using it anymore? SDL_free() it. It's the respectful thing to do. No cap. 💀

🧚 THREAD SAFETY 🧚

Good news, gorgeous: it is safe to call this function from any thread 🌈. Go forth and multithread, you icon.

⭐ AVAILABILITY ⭐

This function has been available since SDL_mixer 3.0.0 — so if you're on anything older, sorry babe, it's not there 🙈

And that's the whole page, bestie!! This was pulled straight from the SDL_mixer 3.2.4 manual, under the MIX_GetTrackTags(3) section of the SDL_mixer3 functions. Slay, go free your allocations 💖🎀✨

📦 where this page comes from