Для каждого MATLAB® функция, которую вы задаете как часть блока.NET, продукт MATLAB Compiler SDK™, генерирует API на основе подписи функции MATLAB.
Подпись single output, которая принимает, что только один выход требуется и возвращает результат в один MWArray вместо массива MWArray.
Подпись standard, которая задает входные параметры типа MWArray и возвращает значения как массив MWArray.
Подпись feval, которая включает оба аргумента ввода и вывода в список аргументов вместо того, чтобы возвратить выходные параметры как возвращаемое значение. Выходные аргументы задаются сначала, сопровождаются входными параметрами.
Для каждой функции MATLAB продукт MATLAB Compiler SDK генерирует класс обертки, который имеет перегруженные методы реализовать различные формы типового вызова функции MATLAB. Один выход API для функции MATLAB возвращает один MWArray.
Как правило, вы используете один выходной интерфейс для функций MATLAB, которые возвращают отдельный аргумент. Можно также использовать один выходной интерфейс, когда это необходимо, чтобы использовать выход функции как вход к другой функции.
Следующая таблица показывает родовой функции foo наряду с одним выходом API, который компилятор генерирует для его нескольких форм.
| Типовая функция MATLAB |
function [Out1, Out2, ..., varargout] = foo(In1, In2, ..., InN, varargin) |
| API, при отсутствии входных параметров |
public MWArray foo() |
| API, если существует один или несколько входных параметров |
public MWArray foo(MWArray In1, |
| API, если существуют дополнительные входные параметры |
public MWArray foo(MWArray In1, MWArray In2, ..., |
В примере, входные параметры In1, In2, и inN имеют тип MWArray.
Точно так же в случае дополнительных аргументов, params аргументы имеют тип MWArray. (varargin аргумент похож на varargin функция в MATLAB — это позволяет пользователю передавать переменное количество аргументов.)
Примечание
Когда вы вызываете метод класса в своем приложении.NET, задаете все необходимые входные параметры сначала, сопровождаемый любыми дополнительными аргументами.
Функции, вводящие одно целое число, требуют, чтобы явный бросок ввел MWNumericArray отличать сигнатуру метода от стандартной интерфейсной подписи, которая не имеет никаких входных параметров.
Как правило, вы используете стандартный интерфейс для функций MATLAB, которые возвращают несколько выходных значений.
Стандартный интерфейс вызова возвращает массив MWArray вместо объекта единого массива.
Следующая таблица показывает стандартный API для родовой функции ни с одним, один, больше чем один или переменное количество аргументов.
| Типовая функция MATLAB |
function [Out1, Out2, ..., varargout] = foo(In1, In2, ..., InN, varargin) |
| API, при отсутствии входных параметров |
public MWArray[] foo(int numArgsOut) |
| API, если существует один входной параметр |
public MWArray [] foo(int numArgsOut, MWArray In1) |
API, если существует два к N входные параметры |
public MWArray[] foo(int numArgsOut, MWArray In1,MWArray In2, \... MWArray InN) |
API, если существуют дополнительные аргументы, представленные varargin аргумент |
public MWArray[] foo(int numArgsOut,MWArray in1,MWArray in2, MWArray InN, params MWArray[] varargin) |
Детали об аргументах для этих выборок стандартных подписей показывают в следующей таблице.
| Аргумент | Описание | Детали |
|---|---|---|
numArgsOut | Количество выходных параметров | Целое число, указывающее на количество выходных параметров, вы хотите, чтобы метод возвратился.
|
In1, In2, ...InN | Необходимые входные параметры | Все аргументы, которые следуют Задайте все необходимые входные параметры сначала. Каждый необходимый вход должен иметь тип |
varargin | Дополнительные входные параметры | Можно также задать дополнительные входные параметры, если код MATLAB использует |
Out1, Out2, ...OutN | Выходные аргументы | Со стандартным интерфейсом вызова все выходные аргументы возвращены как массив |
В дополнение к методам в одном API и стандартном API, в большинстве случаев, продукт MATLAB Compiler SDK производит дополнительный перегруженный метод. Если оригинальный код MATLAB не будет содержать выходных аргументов, то компилятор не сгенерирует feval интерфейс метода.
Рассмотрите функцию со следующей структурой:
function [Out1, Out2, ..., varargout] = foo(In1, In2, ..., InN, varargin)
Компилятор генерирует следующий API, известный как feval interface.
public void foo
(int numArgsOut,
ref MWArray [] ArgsOut,
MWArray[] ArgsIn)
Интерфейс принимает следующие аргументы:
numArgsOut | Количество выходных параметров | Целое число, указывающее на количество выходных параметров, вы хотите возвратиться. Этот номер обычно совпадает с количеством выходных аргументов, которые следуют. |
ref MWArray [] ArgsOut | Выходные аргументы | Следующий
|
MWArray[] ArgsIn | Входные параметры |
Когда вы передаете экземпляр |