audio_exists


Description

This function returns whether a sound exists (true) or not (false). Note that if the index you search for has not been initialised previously, this function will cause an error as it is searching for non-existent asset indices. The sound to check can either be a single instance of a sound (the index for individual sounds being played can be stored in a variable when using the audio_play_sound or audio_play_sound_at functions) or a sound asset.


Syntax:

audio_exists(index);

Argument Description
index The index of the sound to check the existence of.


Returns:

Boolean


Example:

if audio_exists(global.Music)
   {
   audio_play_sound(global.Music, 0, true);
   }

The above code checks to see if a sound exists. If it does it is set to play in a loop.