exponenta event banner

MLAppendMatrix

Создание или добавление матрицы MATLAB с данными из листа Microsoft Excel

Синтаксис

= MLAppendMatrix(var_name,mdat)
MLAppendMatrix var_name,mdat
out = MLAppendMatrix(var_name,mdat)

Описание

= MLAppendMatrix(var_name,mdat) добавляет данные в mdat в матрицу MATLAB ®var_name или создает var_name если он не существует. Этот синтаксис используется при работе непосредственно в документе.

MLAppendMatrix var_name,mdat добавляет данные в mdat в матрицу MATLAB var_name или создает var_name если он не существует. Используйте этот синтаксис в макросе VBA.

out = MLAppendMatrix(var_name,mdat) позволяет выявлять ошибки при выполнении MLAppendMatrix в макросе VBA. Если MLAppendMatrix не удается, то out - строка, содержащая код ошибки. В противном случае out является 0.

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

var_name

Имя матрицы MATLAB, к которой добавляются данные.

var_name в кавычках непосредственно указывает имя матрицы. var_name без кавычек указывает адрес ячейки листа (или имя диапазона), содержащий имя матрицы. Не использовать переменную MATLAB ans как var_name.

mdat

Расположение данных для добавления var_name.

mdat должен быть адресом ячейки листа или именем диапазона. Не включайте его в кавычки.

mdat должен содержать числовые данные или строковые данные. Типы данных не могут быть объединены в диапазоне, указанном в mdat. Пустой mdat ячейки становятся матричными элементами MATLAB, содержащими ноль, если данные числовые, и пустые векторы символов, если данные являются строкой.

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

out

0 если команда выполнена успешно. В противном случае строка, содержащая код ошибки.

Примеры

свернуть все

В этом примере: B является матрицей MATLAB 2 на 2. Добавление данных в диапазон ячеек листа A1:A2 кому B:

MLAppendMatrix("B", A1:A2)
  

A1

  

A2

B теперь является матрицей 2 на 3 с данными из A1:A2 в третьем столбце.

B является матрицей MATLAB 2 на 2. Клетка C1 содержит метку B, и new_data - имя диапазона ячеек, A1:B2. Добавление данных в диапазон ячеек A1:B2 кому B:

MLAppendMatrix(C1, new_data)
  
  

A1

B1

A2

B2

B теперь является матрицей 4 на 2 с данными из A1:B2 в последних двух строках.

Совет

  • MLAppendMatrix проверяет размеры var_name и mdat для определения способа добавления mdat кому var_name. Если размеры допускают добавление mdat как новые строки или новые столбцы, он добавляется mdat кому var_name как новые строки. Если размеры не совпадают, функция возвращает ошибку.

  • Если mdat изначально не является Excel ®Range тип данных и вызов функции из листа, MLAppendMatrix выполняет принуждение необходимого типа.

  • Если mdat не является Excel Range при вызове функции из макроса Microsoft ® Visual Basic ® вызов завершается неуспешно. Сообщение об ошибкеByRef Argument Type Mismatch появляется.

  • Для работы с кодом VBA в Excel с Link™ электронной таблицы необходимо включить ссылку на электронную таблицу в качестве ссылки в редакторе Microsoft Visual Basic. Дополнительные сведения см. в разделе Установка.

См. также

Представлен до R2006a