Создание файла заголовка C foo.h для функции foo который принимает два входных параметра типа double и возвращает значение типа double.

double foo(double in1, double in2);

Запишите функцию C foo.c.

#include <stdio.h>
#include <stdlib.h>
#include "foo.h"

double foo(double in1, double in2)
{
  return in1 + in2;
}

Запись функции callfoo который вызывает foo с помощью coder.ceval. Предоставьте исходные и заголовочные файлы генератору кода в функции.

function y = callfoo  %#codegen
y = 0.0;
if coder.target('MATLAB')
    % Executing in MATLAB, call MATLAB equivalent of
    % C function foo
    y = 10 + 20;
else
    % Executing in generated code, call C function foo
    coder.updateBuildInfo('addSourceFiles','foo.c');
    coder.cinclude('foo.h');
    y = coder.ceval('foo', 10, 20);
end
end

Создание кода библиотеки C для функции callfoo. codegen функция генерирует код C в \codegen\lib\callfoo подпапка.

codegen -config:lib callfoo -report

Запись функции MATLAB myabsval.

function y = myabsval(u)   
%#codegen
y = abs(u);

Создание статической библиотеки C для myabsval, с использованием -args для указания размера, типа и сложности входного параметра.

codegen -config:lib myabsval -args {0.0}

Запишите функцию MATLAB для вызова сгенерированной функции библиотеки C с помощью coder.ceval.

function y = callmyabsval(y)  
%#codegen
% Check the target. Do not use coder.ceval if callmyabsval is
% executing in MATLAB
if coder.target('MATLAB')
  % Executing in MATLAB, call function myabsval
  y = myabsval(y);
else
  % add the required include statements to generated function code
  coder.updateBuildInfo('addIncludePaths','$(START_DIR)\codegen\lib\myabsval');
  coder.cinclude('myabsval_initialize.h');
  coder.cinclude('myabsval.h');
  coder.cinclude('myabsval_terminate.h');

  % Executing in the generated code. 
  % Call the initialize function before calling the 
  % C function for the first time
  coder.ceval('myabsval_initialize');

  % Call the generated C library function myabsval
  y = coder.ceval('myabsval',y);
  
  % Call the terminate function after
  % calling the C function for the last time
  coder.ceval('myabsval_terminate');
end

Создание функции MEX callmyabsval_mex. Предоставьте созданный файл библиотеки в командной строке.

codegen -config:mex callmyabsval codegen\lib\myabsval\myabsval.lib -args {-2.75}

Вместо предоставления библиотеки в командной строке можно использовать coder.updateBuildInfo для указания библиотеки в функции. Используйте этот параметр для предварительной настройки сборки. Добавить эту строку в else блок:

coder.updateBuildInfo('addLinkObjects','myabsval.lib','$(START_DIR)\codegen\lib\myabsval',100,true,true);

Выполнение функции MEX callmyabsval_mex который вызывает функцию библиотеки myabsval.

callmyabsval_mex(-2.75)

ans =

    2.7500

Вызов функции MATLAB callmyabsval.

callmyabsval(-2.75)

ans =

    2.7500

Запись функции MATLAB useGlobal который вызывает функцию C addGlobal. Используйте '-global' флаг, указывающий генератору кода, что функция C использует глобальную переменную.

function y = useGlobal()
global g;
t = g;
% compare execution with/without '-global' flag
coder.ceval('-global','addGlobal'); 
y = t;
end

Создание файла заголовка C addGlobal.h для функции addGlobal.

void addGlobal(void);

Запишите функцию C addGlobal в файле addGlobal.c. Эта функция включает файл заголовка useGlobal_data.h который генератор кода создает при создании кода для функции useGlobal. Этот файл заголовка содержит объявление глобальной переменной для g.

#include "addGlobal.h"
#include "useGlobal_data.h"
void addGlobal(void) {
    g++;
}

Создание функции MEX для useGlobal. Чтобы определить входные данные для генератора кода, объявите глобальную переменную в рабочей области.

global g;
g = 1;
codegen useGlobal -report addGlobal.h addGlobal.c
y = useGlobal_mex();

С помощью '-global' флаг, функция MEX выдает результат y = 1. '-global' флаг указывает генератору кода, что функция C, возможно, изменяет глобальную переменную. Для useGlobalгенератор кода создает этот код:

real_T useGlobal(const emlrtStack *sp)
{
  real_T y;
  (void)sp;
  y = g;
  addGlobal();
  return y;
}

Без '-global' флаг, функция MEX создает y = 2. Потому что нет указания на то, что функция C изменяет g, генератор кода предполагает, что y и g идентичны. Генерируется код C:

real_T useGlobal(const emlrtStack *sp)
{
  (void)sp;
  addGlobal();
  return g;
}

Предположим, что у вас есть функция C testRM предназначен для использования макета основной строки. Требуется интегрировать эту функцию в функцию MATLAB. bar который работает на массивах. Функция bar предназначен для использования основной компоновки столбца, с использованием coder.columnMajor директива.

function out = bar(in)
%#codegen
coder.columnMajor;
coder.ceval('-layout:rowMajor','testRM', ...
    coder.rref(in),coder.wref(out));
end

В созданном коде генератор кода вставляет в переменную преобразование макета из основного макета столбца в основной макет строки. in перед передачей в testRM. На выходной переменной out, генератор кода вставляет преобразование макета обратно в столбец-мажор.

В общем случае, если не указать layout опция для coder.ceval, предполагается, что аргументы внешней функции используют столбец-мажор.

Предположим, что у вас есть функция MATLAB, которая вызывает пользовательский код C, который принимает ввод комплексных чисел. Необходимо определить параметры ввода кода C таким образом, чтобы вводимые комплексные номера из функции MATLAB могли отображаться на код C.

В сгенерированном коде комплексные числа определяются как struct имеет два поля, re и im, которые являются действительной и мнимой частью комплексного числа соответственно. Это struct определен в файле заголовка rtwtypes.h, который вы можете найти в codegen\lib\functionName папку текущего пути. struct определяется следующим образом:

typedef struct {
    real32_T re; /*Real Component*/
    real32_T im; /*Imaginary Component*/
} creal32_T;

Дополнительные сведения см. в разделе Сопоставление типов MATLAB типам в сгенерированном коде.

Код C, который требуется интегрировать, должен включать rtwtypes.h файл заголовка. Пример кода C foo.c показано ниже:

#include "foo.h"
#include<stdio.h>
#include<stdlib.h>
#include "rtwtypes.h"

double foo(creal32_T x) {
    double z = 0.0;
    z = x.re*x.re + x.im*x.im;
    return (z);
}

struct назван creal32_T. Файл заголовка foo.h также должны быть определены как:

#include "rtwtypes.h"
double foo(creal32_T x);

Выполняется код MATLAB foo.c с помощью coder.ceval функция, имеющая ввод комплексных чисел:

function y = complexCeval  %#codegen
y = 0.0;
coder.updateBuildInfo('addSourceFiles','foo.c');
coder.cinclude('foo.h');
y = coder.ceval('foo', 10+20i);
end

Создание кода для функции complexCeval путем выполнения этой команды:

codegen -config:lib -report complexCeval