Audio.length Function

Format

d = audio_name.length();

Description

The Audio.length function returns the length in seconds of the recording in an Audio object.

The Audio.length function only supports audio recorded as AAC encoded audio in an mp4 container (.m4a). This is the format used for audio recorded by CSPro so it will work correctly for audio recorded using the Audio.record or Audio.recordInteractive. The length function will return default for audio files recorded by other tools that use a different format such as mp3 or wav.

Return Value

The function returns the duration in seconds (and fractional seconds) of the audio recording or default if the duration cannot be computed.

Example

Audio recording;
numeric seconds = recording.recordInteractive();
if seconds > 0 then
recording.save("recording.m4a");
else
errmsg("No audio recorded. Please try again");
reenter;
endif;

See also: Audio Object