MIX_GetTaggedTracks(3)

📦
version 3.2.4 · 2 versions
, in fedora 44

✨ MIX_GetTaggedTracks ✨

okay so bestie, this is a page from the SDL_mixer3 function manual, and today's main character is MIX_GetTaggedTracks — the one that goes "hey mixer, gimme every track that's rocking this specific tag" 💖

🌸 NAME 🌸

MIX_GetTaggedTracks — get all tracks with a specific tag. that's it, that's the vibe 🎀

🦋 SYNOPSIS 🦋

#include <SDL3_mixer/SDL_mixer.h>

MIX_Track ** MIX_GetTaggedTracks(MIX_Mixer *mixer, const char *tag, int *count);

💅 DESCRIPTION 💅

so like. you ask for a tag, you get back all the tracks wearing that tag. simple, iconic, no notes.

heads up though: tracks are not provided in any guaranteed order. it's giving chaos, honestly. if you need them sorted, that's on you, bestie 😭

🫶 FUNCTION PARAMETERS 🫶

  • mixer — the mixer to query. the one you're interrogating 🕵️‍♀️
  • tag — the tag to search. your search term, your roman empire, your keyword ✨
  • count — a pointer that gets filled in with the number of tracks returned. it can be NULL if you don't care, and honestly valid of you 💅

🔥 RETURN VALUE 🔥

Returns an array of the tracks, NULL-terminated — or NULL on failure, in which case call SDL_GetError() for more info because we deserve answers 😤

🚨 IMPORTANT: the returned pointer should be freed with SDL_free() when it is no longer needed. do not ghost that memory, she will remember 😭

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. yes queen, take it everywhere, she's chill 💜

⭐ AVAILABILITY ⭐

This function is available since SDL_mixer 3.0.0. vintage but make it current 👑

and that's the whole page, no cap. this was the MIX_GetTaggedTracks man page from the SDL_mixer manual, version SDL_mixer 3.2.4. mwah, go free that array, ily 🫶💖

📦 where this page comes from