audio_exists

Checks whether the given sound exists.

Syntax:

audio_exists(index);


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


Returns: Boolean


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.


Example:

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

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


Back: Audio
Next: audio_get_name
© Copyright YoYo Games Ltd. 2015 All Rights Reserved