xlsread

(Не рекомендуемый) Чтение файла электронной таблицы Microsoft Excel

xlsread не рекомендуется. Использовать readtable, readmatrix, или readcell вместо этого. Для получения дополнительной информации см. раздел Вопросов совместимости.

Синтаксис

num = xlsread(filename)

num = xlsread(filename,sheet)

num = xlsread(filename,xlRange)

num = xlsread(filename,sheet,xlRange)

num = xlsread(filename,sheet,xlRange,'basic')

[num,txt,raw]
= xlsread(___)

___ = xlsread(filename,-1)

[num,txt,raw,custom]
= xlsread(filename,sheet,xlRange,'',processFcn)

Описание

пример

num = xlsread(filename) считывает первый лист в Microsoft^® Excel^® книга электронных таблиц с именем filename и возвращает числовые данные в матрице.

num = xlsread(filename,sheet) считывает указанный лист.

пример

num = xlsread(filename,xlRange) читается из заданной области первого листа в книге. Используйте синтаксис области значений Excel, например 'A1:C3'.

пример

num = xlsread(filename,sheet,xlRange) считывает из заданного листа и области значений.

num = xlsread(filename,sheet,xlRange,'basic') считывает данные из электронной таблицы в basic режим импорта. Если на вашем компьютере нет Excel для Windows^® или если вы используете MATLAB^® Online™, xlsread автоматически работает в basic режим импорта, поддерживающий файлы XLS, XLSX, XLSM, XLTX и XLTM.

Если вы не задаете все аргументы, используйте пустые символьные векторы '' , как заполнители, для примера, num = xlsread(filename,'','','basic').

пример

[num,txt,raw] = xlsread(___) дополнительно возвращает текстовые поля в массиве ячеек txt, и числовые и текстовые данные в массиве ячеек raw, с использованием любого из входных параметров в предыдущих синтаксисах.

___ = xlsread(filename,-1) открывает окно Excel для интерактивного выбора данных. Выберите лист, перетащите мышь в нужную область значений и нажмите OK. Этот синтаксис поддерживается только на компьютерах с установленным программным обеспечением Microsoft Excel.

пример

[num,txt,raw,custom] = xlsread(filename,sheet,xlRange,'',processFcn), где processFcn является указателем на функцию, читает из электронной таблицы, вызывает processFcn на данных и возвращает конечные результаты в виде числовых данных в массиве num. The xlsread функция возвращает текстовые поля в массиве ячеек txt, как числовые, так и текстовые данные в массиве ячеек raw, и второй выход от processFcn в массиве custom. The xlsread функция не изменяет данные, хранящиеся в электронной таблице. Этот синтаксис поддерживается только на компьютерах Windows с программным обеспечением Excel.

Примеры

свернуть все

Чтение листа в числовую матрицу

Создайте файл Excel с именем myExample.xlsx.

values = {1, 2, 3 ; 4, 5, 'x' ; 7, 8, 9};
headers = {'First','Second','Third'};
xlswrite('myExample.xlsx',[headers; values]);

Sheet1 от myExample.xlsx содержит:

   First    Second    Third
       1         2        3
       4         5    x    
       7         8        9

Считайте числовые данные из первого листа.

filename = 'myExample.xlsx';
A = xlsread(filename)

A =
     1     2     3
     4     5   NaN
     7     8     9

Чтение Области значений из Камер

Считайте определенную область значений данных из файла Excel в предыдущем примере.

filename = 'myExample.xlsx';
sheet = 1;
xlRange = 'B2:C3';

subsetA = xlsread(filename,sheet,xlRange)

subsetA =
     2     3
     5   NaN

Чтение столбца

Прочтите второй столбец из файла Excel в первом примере.

filename = 'myExample.xlsx';

columnB = xlsread(filename,'B:B')

columnB =
     2
     5
     8

Для повышения эффективности включите номера строк в область значений, например 'B1:B3'.

Запрос числовых, текстовых и необработанных данных

Запросите числовые данные, текстовые данные и объединенные данные из файла Excel в первом примере.

[num,txt,raw] = xlsread('myExample.xlsx')

num =
     1     2     3
     4     5   NaN
     7     8     9

txt = 
    'First'    'Second'    'Third'
    ''         ''          ''     
    ''         ''          'x'    

raw = 
    'First'    'Second'    'Third'
    [    1]    [     2]    [    3]
    [    4]    [     5]    'x'    
    [    7]    [     8]    [    9]

Выполнение функции в листе

В редакторе создайте функцию для обработки данных из листа. В этом случае установите значения вне области значений [0.2,0.8] на 0.2 или 0.8.

function [Data] = setMinMax(Data)

minval = 0.2; 
maxval = 0.8;
 
for k = 1:Data.Count
  v = Data.Value{k};
  if v > maxval
    Data.Value{k} = maxval;
  elseif v < minval
    Data.Value{k} = minval;
  end
end

В Командном окне добавьте случайные данные к myExample.xlsx.

A = rand(5);
xlswrite('myExample.xlsx',A,'MyData')

Лист с именем MyData содержит значения в диапазоне от 0 до 1.

Считайте данные из листа и сбросьте все значения вне области значений [0.2,0.8]. Укажите имя листа, но используйте '' как заполнители для xlRange и 'basic' входы.

trim = xlsread('myExample.xlsx','MyData','','',@setMinMax);

Запрос пользовательского выхода

Выполните функцию на листе и отобразите пользовательский выход индекса.

В редакторе измените функцию setMinMax из предыдущего примера, чтобы вернуть индексы измененных элементов (пользовательский выход).

function [Data,indices] = setMinMax(Data)

minval = 0.2; 
maxval = 0.8;
indices = [];
 
for k = 1:Data.Count
  v = Data.Value{k};
  if v > maxval
    Data.Value{k} = maxval;
    indices = [indices k];
  elseif v < minval
    Data.Value{k} = minval;
    indices = [indices k];
  end  
end

Считайте данные из таблицы MyDataи запросите пользовательский выход индекса, idx.

[trim,txt,raw,idx] = xlsread('myExample.xlsx',...
    'MyData','','',@setMinMax);

Входные параметры

свернуть все

`filename` - Имя файла
вектор символов | строка

Имя файла, заданное как вектор символов или строка. Если расширение не включено, xlsread ищет файл с заданным именем и поддерживаемым расширением Excel. xlsread можно считать данные, сохраненные в файлах, которые в данный момент открыты в Excel для Windows.

Пример: 'myFile.xlsx' или "myFile.xlsx"

Типы данных: char | string

`sheet` - Лист
вектор символов | строка | положительное целое число

Лист, заданный как один из следующих:

Вектор символов, содержащая имя листа. Имя не может содержать двоеточие (:). Для определения имен листов в файле электронной таблицы используйте xlsfinfo. Для файлов XLS в basic режим, sheet учитывает регистр.
Положительное целое число, указывающее на индекс листа. Эта опция не поддерживается для файлов XLS в basic режим.

`xlRange` - Прямоугольная область значений
вектор символов | строка

Прямоугольная область значений, заданный как вектор символов или строка.

Задайте xlRange использование двух противоположных углов, которые определяют считываемую область. Для примера, 'D2:H4' представляет прямоугольную область 3 на 5 между двумя углами D2 и H4 на листе. The xlRange вход не чувствителен к регистру и использует стиль ссылки A1 Excel (см. справку Excel).

Выбор области значений не поддерживается при чтении файлов XLS в basic режим. В этом случае используйте '' вместо xlRange.

Если вы не задаете sheet, затем xlRange должны включать оба угла и символ двоеточия, даже для одной камеры (например 'D2:D2'). В противном случае xlsread интерпретирует вход как имя листа (например 'sales' или 'D2').

Если вы задаете sheet, затем xlRange:

Не нужно включать двоеточие и противоположный угол, чтобы описать одну камеру.
Может ссылаться на именованную область значений, определенный в файле Excel (см. справку Excel).

Когда заданный xlRange перекрывает объединенные камеры:

На компьютерах Windows с Excel, xlsread расширяет область значений, включая все объединенные камеры.
На компьютерах без Excel для Windows, xlsread Возвраты данные только для заданной области, с пустыми или NaN значения для объединенных камер.

Типы данных: char | string

`'basic'` - Флаг для запроса чтения `basic` способ
вектор символов | строка

Флаг для запроса чтения basic mode, заданный как вектор символов или строка, 'basic'.

basic режим по умолчанию для компьютеров без Excel для Windows. В basic режим, xlsread:

Чтение только файлов XLS, XLSX, XLSM, XLTX и XLTM.
Не поддерживает xlRange входы при чтении файлов. В этом случае используйте '' вместо xlRange.
Не поддерживает входы указателя на функцию.
Импорт всех дат в виде серийных номеров дат Excel. Серийные номера дат Excel используют другую ссылочную дату, чем номера дат MATLAB.

Типы данных: char | string

`processFcn` - Указатель на пользовательскую функцию
указатель на функцию

Указатель на пользовательскую функцию. Этот аргумент поддерживается только на компьютерах Windows с программным обеспечением Excel. xlsread читает из электронной таблицы, выполняет функцию на копии данных и возвращает конечные результаты. xlsread не изменяет данные, хранящиеся в электронной таблице.

Когда xlsread вызывает пользовательскую функцию, она передает интерфейс области значений из приложения Excel, чтобы предоставить доступ к данным. Пользовательская функция должна включать этот интерфейс как в качестве входа, так и в качестве выходного аргумента. (См. «Выполнение функции на листе»)

Пример: @myFunction

Выходные аргументы

свернуть все

`num` - Числовые данные
матрица

Числовые данные, возвращенные как матрица double значения. Массив не содержит никакой информации из линий заголовка, или из внешних строк или столбцов, которые содержат нечисловые данные. Текстовые данные во внутренних строках и столбцах электронных таблиц отображаются следующим NaN в num выход.

`txt` - Текстовые данные
массив ячеек

Текстовые данные, возвращенные как массив ячеек. Числовые значения во внутренних строках и столбцах электронных таблиц отображаются как пустые символьные векторы, '', в txt.

Для файлов XLS в basic режим импорта, txt выход содержит пустые символьные векторы, '', вместо начальных столбцов числовых данных, которые предшествуют текстовым данным в электронной таблице. Во всех других случаях txt не содержит эти дополнительные столбцы.

Неопределенные значения (такие как '#N/A') появляются в txt выход как '#N/A', за исключением XLS- файлов в basic режим.

`raw` - Числовые и текстовые данные
массив ячеек

Числовые и текстовые данные из листа, возвращенные как массив ячеек.

На компьютерах с Excel для Windows неопределенные значения (такие как '#N/A') появляются в raw выход как 'ActiveX VT_ERROR:'. Для файлов XLSX, XLSM, XLTX и XLTM на других компьютерах или в MATLAB Online неопределенные значения отображаются следующим '#N/A'.

`custom` - Второй выход функции, соответствующей processFcn
определяется функцией

Второй выход функции, соответствующей processFcn. Значение и тип данных custom определяются функцией.

Ограничения

xlsread считывает только 7-битные символы ASCII.
xlsread не поддерживает несмежные области значений.
Если на вашем компьютере нет Excel для Windows или используется MATLAB Online, xlsread автоматически работает в basic режим импорта.
На Linux^® и платформы Mac, xlsread невозможно открыть файлы электронной таблицы, написанные writetable функция.

Алгоритмы

xlsread импортирует форматированный текст, представляющий даты (например '10/31/96'), кроме случаев импорта в basic режим.

Вопросы совместимости

расширить все

`xlsread` не рекомендуется

Не рекомендуемый запуск в R2019a

xlsread не рекомендуется. Использовать readtable, readmatrix, или readcell вместо этого. Нет планов по удалению xlsread.

Начиная с R2019a, импортируйте данные электронных таблиц как таблицу, матрицу или массив ячеек при помощи readtable, readmatrix, или readcell соответственно. The readtable, readmatrix, и readcell функции имеют эти преимущества по сравнению с xlsread функция:

Лучшая поддержка и эффективность кросс-платформ
Автоматическое обнаружение формата и типов данных
Возможность использовать настройки импорта для контроля процесса импорта данных, включая обработку ошибок и недостающих данных

В этой таблице показаны типичные использования xlsread и как обновить код, чтобы использовать readtable, readmatrix, или readcell вместо этого.

Не рекомендуется	Рекомендуется
Считайте данные электронных таблиц как матрицу, используя `xlsread`: M = xlsread(filename)	Считайте данные электронных таблиц как таблицу: T = readtable(filename) Однако, чтобы продолжить чтение ваших данных как матрицы, используйте: M = readmatrix(filename)
Считайте данные электронных таблиц как массив ячеек с помощью `xlsread`: [~,~,C] = xlsread(filename)	Импортируйте данные электронных таблиц как таблицу: T = readtable(filename) Однако, чтобы продолжить импорт данных как массива камер, используйте: C = readcell(filename)
Считайте определенный лист и область значений как матрицу, используя `xlsread`: M = xlsread(filename,sheet,range)	Считайте определенный лист и область значений как таблицу: T = readtable(filename,'Sheet',sheet,'Range',range) Однако, чтобы продолжить чтение ваших данных как матрицы, используйте: M = readmatrix(filename,'Sheet',sheet,'Range',range)
Считайте определенный лист и область значений как массив ячеек с помощью `xlsread`: [~,~,C] = xlsread(filename,sheet,range)	Считайте определенный лист и область значений как таблицу: T = readtable(filename,'Sheet',sheet,'Range',range) Однако, чтобы продолжить чтение данных как массива ячеек: C = readcell(filename,'Sheet',sheet,'Range',range)

Не рекомендуется

Рекомендуется

Считайте данные электронных таблиц как матрицу, используя xlsread:

M = xlsread(filename)

Считайте данные электронных таблиц как таблицу:

T = readtable(filename)

Однако, чтобы продолжить чтение ваших данных как матрицы, используйте:

M = readmatrix(filename)

Считайте данные электронных таблиц как массив ячеек с помощью xlsread:

[~,~,C] = xlsread(filename)

Импортируйте данные электронных таблиц как таблицу:

T = readtable(filename)

Однако, чтобы продолжить импорт данных как массива камер, используйте:

C = readcell(filename)

Считайте определенный лист и область значений как матрицу, используя xlsread:

M = xlsread(filename,sheet,range)

Считайте определенный лист и область значений как таблицу:

T = readtable(filename,'Sheet',sheet,'Range',range)

Однако, чтобы продолжить чтение ваших данных как матрицы, используйте:

M = readmatrix(filename,'Sheet',sheet,'Range',range)

Считайте определенный лист и область значений как массив ячеек с помощью xlsread:

[~,~,C] = xlsread(filename,sheet,range)

Считайте определенный лист и область значений как таблицу:

T = readtable(filename,'Sheet',sheet,'Range',range)

Однако, чтобы продолжить чтение данных как массива ячеек:

C = readcell(filename,'Sheet',sheet,'Range',range)

См. также

Документация

xlsread

Синтаксис

Описание

Примеры

Чтение листа в числовую матрицу

Чтение Области значений из Камер

Чтение столбца

Запрос числовых, текстовых и необработанных данных

Выполнение функции в листе

Запрос пользовательского выхода

Входные параметры

`filename` - Имя файла
вектор символов | строка

`sheet` - Лист
вектор символов | строка | положительное целое число

`xlRange` - Прямоугольная область значений
вектор символов | строка

`'basic'` - Флаг для запроса чтения `basic` способ
вектор символов | строка

`processFcn` - Указатель на пользовательскую функцию
указатель на функцию

Выходные аргументы

`num` - Числовые данные
матрица

`txt` - Текстовые данные
массив ячеек

`raw` - Числовые и текстовые данные
массив ячеек

`custom` - Второй выход функции, соответствующей processFcn
определяется функцией

Ограничения

Алгоритмы

Вопросы совместимости

`xlsread` не рекомендуется

См. также

Темы

Документация MATLAB

Поддержка

Документация

xlsread

Синтаксис

Описание

Примеры

Чтение листа в числовую матрицу

Чтение Области значений из Камер

Чтение столбца

Запрос числовых, текстовых и необработанных данных

Выполнение функции в листе

Запрос пользовательского выхода

Входные параметры

filename - Имя файла вектор символов | строка

sheet - Лист вектор символов | строка | положительное целое число

xlRange - Прямоугольная область значений вектор символов | строка

'basic' - Флаг для запроса чтения basic способ вектор символов | строка

processFcn - Указатель на пользовательскую функцию указатель на функцию

Выходные аргументы

num - Числовые данные матрица

txt - Текстовые данные массив ячеек

raw - Числовые и текстовые данные массив ячеек

custom - Второй выход функции, соответствующей processFcn определяется функцией

Ограничения

Алгоритмы

Вопросы совместимости

xlsread не рекомендуется

См. также

Темы

Документация MATLAB

Поддержка

`filename` - Имя файла
вектор символов | строка

`sheet` - Лист
вектор символов | строка | положительное целое число

`xlRange` - Прямоугольная область значений
вектор символов | строка

`'basic'` - Флаг для запроса чтения `basic` способ
вектор символов | строка

`processFcn` - Указатель на пользовательскую функцию
указатель на функцию

`num` - Числовые данные
матрица

`txt` - Текстовые данные
массив ячеек

`raw` - Числовые и текстовые данные
массив ячеек

`custom` - Второй выход функции, соответствующей processFcn
определяется функцией

`xlsread` не рекомендуется