NAME¶

Mix_HasMusicDecoder - Check if a music decoder is available by name.

SYNOPSIS¶

#include "SDL3_mixer/SDL_mixer.h"

SDL_bool Mix_HasMusicDecoder(const char *name);

DESCRIPTION¶

This result can change between builds AND runs of the program, if external libraries that add functionality become available. You must successfully call Mix_OpenAudio () before calling this function, as decoders are activated at device open time.

Decoder names are arbitrary but also obvious, so you have to know what you're looking for ahead of time, but usually it's the file extension in capital letters (some example names are "MOD", "MP3", "FLAC").

FUNCTION PARAMETERS¶

name

the decoder name to query.

RETURN VALUE¶

Returns SDL_TRUE if a decoder by that name is available, SDL_FALSE otherwise.

AVAILABILITY¶

This function is available since SDL_mixer 3.0.0

SEE ALSO¶

Mix_GetNumMusicDecoders(3), Mix_GetMusicDecoder(3)