(This function is part of SDL_mixer, a separate library from SDL.)

Mix_HasMusicDecoder

Check if a music decoder is available by name.

Header File

Syntax

bool Mix_HasMusicDecoder(const char *name);

Function Parameters

const char *

name

the decoder name to query.

Return Value

(bool) Returns true if a decoder by that name is available, false otherwise.

Remarks

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").

Version

This function is available since SDL_mixer 3.0.0