AudioFileLength

          (System Library)

Description:              This function returns the length of a RIFF format Wave file in seconds.

Returns:                    Numeric

Usage:                       Script or Steady State

Format:                      \System\AudioFileLength(Filename)

Parameters:             Filename   { text }  { required }  { no default: }

                                                The full name of a .wav file for which you want to find the audio play length.

Comments:               This module is a member of the System Library, and must therefore be prefaced by \System\, as shown in the "Format" section. If the application you are developing is a script application, the System variable must be declared in APPMOD.SRC and need not be prefaced by a backslash in the function call.

                                    Returns invalid if the file does not exist, or if the length cannot be determined.

Example:

PlayingTime = AudioFileLengh(AlarmMessage.wav);