This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

read

Read next consecutive audio file

Syntax

data = read(ADS)
[data,info] = read(ADS)

Description

example

data = read(ADS) returns audio extracted from the datastore. Each subsequent call to the read function continues reading from the endpoint of the previous call.

example

[data,info] = read(ADS) also returns information about the extracted audio data.

Examples

collapse all

Specify the file path to the audio samples included with Audio Toolbox™. Create an audio datastore that points to the specified folder.

folder = fullfile(matlabroot,'toolbox','audio','samples');
ADS = audioDatastore(folder);

While the audio datastore has unread files, read consecutive files from the datastore. Use progress to monitor the fraction of files read.

while hasdata(ADS)
    data = read(ADS);
    fprintf('Fraction of files read: %.2f\n',progress(ADS))
end
Fraction of files read: 0.03
Fraction of files read: 0.07
Fraction of files read: 0.10
Fraction of files read: 0.14
Fraction of files read: 0.17
Fraction of files read: 0.21
Fraction of files read: 0.24
Fraction of files read: 0.28
Fraction of files read: 0.31
Fraction of files read: 0.34
Fraction of files read: 0.38
Fraction of files read: 0.41
Fraction of files read: 0.45
Fraction of files read: 0.48
Fraction of files read: 0.52
Fraction of files read: 0.55
Fraction of files read: 0.59
Fraction of files read: 0.62
Fraction of files read: 0.66
Fraction of files read: 0.69
Fraction of files read: 0.72
Fraction of files read: 0.76
Fraction of files read: 0.79
Fraction of files read: 0.83
Fraction of files read: 0.86
Fraction of files read: 0.90
Fraction of files read: 0.93
Fraction of files read: 0.97
Fraction of files read: 1.00

Specify the file path to the audio samples you want to include in the audio datastore. In this example, the samples are located on a local desktop. Create an audio datastore that points to the specified folder.

folder = 'C:\Users\bhemmat\Desktop';
ADS = audioDatastore(folder,'LabelSource','foldernames');

When you read data from the datastore, you can additionally return information about the data as a struct. The information struct contains the file name, any labels associated with the file, and the sample rate of the file.

[data,info] = read(ADS);
info
info = 

  struct with fields:

    SampleRate: 44100
      FileName: 'C:\Users\bhemmat\Desktop\Turbine-16-44p1-mono-22secs.wav'
         Label: Desktop

Input Arguments

collapse all

Specify ADS as an audioDatastore object.

Output Arguments

collapse all

Audio data, returned as a M-by-N matrix, where:

  • M –– Total samples per channel in file.

  • N –– Number of channels in file.

Information about audio data, returned as a struct with the following fields:

  • FileName –– Name of the current file.

  • Label –– All labels of the file.

  • SampleRate –– Sample rate of the file.

Introduced in R2018b