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

Пример: Снова используйте вложенную структуру Выходной тип как входной тип

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

В целях этого примера предположите, что тип данных является вложенной структурой с массивом переменного размера, сохраненным в свойстве самого низкого уровня. Вы хотите назвать этот тип структуры squiggle в сгенерированном коде. В MATLAB вы пишете функцию построения для типа данных под названием myConstuctor:

function [out] = myConstructor(a, b)
% create a variable-sized array with upper bounds of 100-by-100
coder.varsize('myStruct.f1.f2.f3.f4', [100 100], [1 1]);
% define the nested structure type
myStruct = struct('f1', struct('f2', struct('f3', struct('f4', zeros(a,b) ))));
% specify the name of the structure and one of its fields
coder.cstructname(myStruct.f1.f2.f3,'squiggle_f3');
coder.cstructname(myStruct,'squiggle');
out = myStruct;

Вы пишете вторую функцию, useConstructor, который берет тип squiggle, как введено, выполняет сложение и продвигает дополнительные столбцы на в конец данных.

function x = useConstructor(x, n)
xz = x.f1.f2.f3.f4;
b = zeros(size(xz,1),1);
for i = 1:n
    xz = [(xz + pi), b];
end
x.f1.f2.f3.f4 = xz;

Чтобы сгенерировать код для myConstructor и useConstructor и обработать их как, нескольких точку входа функционирует, необходимо задать входные типы для обеих функций. Задайте входные типы для myConstructor при помощи двух целых чисел. Для useConstructor задайте входной тип как выходной тип от myConstructor при помощи coder.OutputType 'OutputType' :

v = coder.OutputType('myConstructor');
codegen myConstructor -args {5,1} useConstructor -args {v,3} -report -config:lib

В сгенерированном коде выравниваются функциональные интерфейсы. Две функции точки входа используют то же определение типа для squiggle. Можно использовать сгенерированный код для конструктора, чтобы создать входной тип для сгенерированного кода для useConstructor.

Пример: Вручную Задайте Входной Тип Без Использования кодера. 'OutputType'

Если вы не используете coder.OutputType, чтобы задать входной тип для useConstructor, необходимо задать входной тип при помощи coder.typeof и свойств класса coder.StructType:

% MATLAB type definition for squiggle
myStruct = struct('f1', struct('f2', struct('f3', struct('f4', zeros(2) ))));
t = coder.typeof(myStruct);
t.Fields.f1.Fields.f2.Fields.f3.Fields.f4 = coder.typeof(zeros(2), [100 100], [1 1]);
t.Fields.f1.Fields.f2.Fields.f3.TypeName = 'squiggle_f3';
t.TypeName = 'squiggle';

Чтобы сгенерировать статический код библиотеки, войдите:

codegen myConstructor -args {5,1} useConstructor -args {t,3} -report -config:lib

Как в первом примере, выравниваются функциональные интерфейсы. Однако создание и поддержание определения типа для squiggle являются трудоемкими. Изменения, которые вы вносите в определение типа, должны быть реплицированы в два места: функция myConstructor и текущая переменная рабочей области t. Эти изменения могут упасть из синхронизации, особенно при работе со сложными определениями типа. Используйте coder.OutputType, чтобы помочь в вашем процессе разработки.

Пример: Создайте кодер Конструктора и Использования. OutputType, чтобы Передать Выходной Тип

Рассмотрите функциональный useSparse, который выполняет операцию на входном параметре разреженной матрицы.

function out = useSparse(in)
%#codegen
out = in*2;

Если вы генерируете код для useSparse, необходимо вручную создать соответствующий входной тип на C/C++. Чтобы автоматизировать и упростить конструкцию типа, запишите конструктору для разреженной матрицы.

function A = makeSparse(i,j,v,m,n)
%#codegen
A = sparse(i,j,v,m,n);

Чтобы сгенерировать код, используйте coder.OutputType, чтобы передать вывод от конструктора как входной параметр к useSparse. Задайте свой входной параметр как матрицу 3 на 5.

t = coder.OutputType('makeSparse');
S = round(rand(3,5));
[m,n] = size(S);
[i,j,v] = find(S);
i = coder.typeof(i,[inf 1]); % allow number of nonzero entries to vary
codegen makeSparse -args {i,i,i,m,n} useSparse -args {t} -report

Используя сгенерированный код C/C++, можно вызвать makeSparse, чтобы сгенерировать входной параметр к useSparse. Функция coder.OutputType дает возможность создавать и выравнивать интерфейс для отдельных функций точки входа, которые принадлежат общей кодовой базе.