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

Когда объявлять функцию внешней

Это некоторые распространенные ситуации, в которых вы можете рассмотреть возможность объявления функции MATLAB внешней:

Использование coder.extrinsic Конструкция

Объявление функции foo как extinsic, включите этот оператора в код MATLAB.

coder.extrinsic('foo')

При объявлении функций как внешних для генерации кода придерживайтесь следующих правил:

Для получения дополнительной информации и примеров смотрите coder.extrinsic.

Генератор кода автоматически обрабатывает многие общие функции визуализации MATLAB, такие как plot, disp, и figure, как внешняя. Вы не должны явно объявить их как внешние функции при помощи coder.extrinsic. Для примера можно хотеть позвонить plot визуализация результатов в среде MATLAB. Если вы генерируете MEX-функцию из функции, которая вызывает plot, а затем запустите сгенерированную MEX-функцию, генератор кода отправляет вызовы на plot функцию для движка MATLAB. Если вы генерируете библиотеку или исполняемый файл, сгенерированный код не содержит вызовов plot функция.

Если при помощи MATLAB Coder™ вы генерируете MEX или автономный код C/C + +, в отчете о генерации кода подсвечиваются вызовы из кода MATLAB во внешние функции. При проверке отчета можно определить, какие функции поддерживаются только в среде MATLAB.

function y = foo %#codegen
coder.extrinsic('rat','min');
[N D] = rat(pi);
y = 0;
y = min(N, D);

classdef myClass
    properties
        prop = 1
    end
    methods
        function y = foo(obj,x)
            y = obj.prop + x;
        end
    end
end

function y = myFunction(x) %#codegen
coder.extrinsic('foo');
obj = myClass;
y = foo(obj,x);
end

Вызов функций MATLAB с помощью feval

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

Рассмотрим следующий пример:

function y = foo 
coder.extrinsic('rat');
[N D] = rat(pi);
y = 0;
y = feval('min',N,D);

Поскольку feval является внешним, оператор feval('min',N,D) оценивается MATLAB - не скомпилирован - который имеет тот же результат, что и объявление функции min extinsic только для этого одного вызова. Напротив, функция rat является внешним по всей функции foo.

Генератор кода не поддерживает использование feval вызов локальных функций или функций, расположенных в частной папке.

Работа с mxArrays

Выход внешней функции является mxArray, также известный как массив MATLAB. Единственные допустимые операции для mxArrays являются:

Как использовать mxArray возвращенная внешней функцией в других операциях (для примера, возвращая ее из блока MATLAB Function в выполнение Simulink), необходимо сначала преобразовать ее в известный тип.

Если входные параметры функции mxArraysгенератор кода автоматически обрабатывает функцию как внешнюю.

function y = foo %#codegen
coder.extrinsic('rat');
[N D] = rat(pi);
y = min(N,D);

Function output 'y' cannot be an mxArray in this context. 
Consider preinitializing the output variable with a known type.

function y = foo %#codegen
coder.extrinsic('rat');
[N D] = rat(pi);
y = 0; % Define y as a scalar of type double
y = min(N,D);

Ограничения на использование внешних функций

Полное окружение выполнения MATLAB не поддерживается во время генерации кода. Поэтому при внешнем вызове функций MATLAB применяются следующие ограничения: