Scroll to navigation

Mix_HasMusicDecoder(3) SDL_mixer3 FUNCTIONS Mix_HasMusicDecoder(3)

NAME

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

HEADER FILE

Defined in SDL3_mixer/SDL_mixer.h

SYNOPSIS

#include "SDL3_mixer/SDL_mixer.h"
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

the decoder name to query.

RETURN VALUE

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

AVAILABILITY

This function is available since SDL_mixer 3.0.0

SEE ALSO

(3), Mix_GetNumMusicDecoders(3), (3), Mix_GetMusicDecoder(3)

SDL_mixer 3.0.0 SDL_mixer