Опубликовать интерфейс в библиотеке C++ с использованием исходных файлов

В этом примере создается интерфейс MATLAB ® с библиотекой C++, объявленной в файле заголовкаmatrixOperations.hpp и определено в исходном файле C++ matrixOperations.cpp. MATLAB предоставляет эти исходные файлы для использования в этом примере. Файлы находятся в этой папке:

fullfile(matlabroot,'extern','examples','cpp_interface')

В этом примере создается файл общей библиотеки. Пример использования файла общей библиотеки, предварительно созданного MATLAB, см. в разделе Публикация интерфейса в общей библиотеке C++ в Windows.

Проверка выбранного компилятора C++

Можно использовать любой компилятор C++, поддерживаемый MathWorks. Чтобы убедиться в наличии компилятора C++, введите:

mex -setup cpp

В этом примере используется компилятор Microsoft Visual C++ 2017.

Создать файл определения

Определите имена и пути к артефактам библиотеки C++.

productPath = fullfile(matlabroot,'extern','examples','cpp_interface');
hppFile = 'matrixOperations.hpp';
cppFile = 'matrixOperations.cpp';

Звонить clibgen.generateLibraryDefinition.

clibgen.generateLibraryDefinition(fullfile(productPath,hppFile),...
    "SupportingSourceFiles",fullfile(productPath,cppFile),...
    "IncludePath",productPath,...
    "ReturnCArrays",false) % treat output as MATLAB arrays

Using Microsoft Visual C++ 2017 compiler.
Generated definition file definematrixOperations.mlx and data file 'matrixOperationsData.xml' 
contain definitions for 10 constructs supported by MATLAB.
5 construct(s) require(s) additional definition. To include these construct(s) in the interface, 
edit the definitions in definematrixOperations.mlx.
Build using build(definematrixOperations).

Определение отсутствующих конструкций

Чтобы определить отсутствующие конструкции, щелкните ссылку в generateLibraryDefinition выводимое сообщение для редактирования определений в definematrixOperations.mlx. Сведения о редактировании этого файла и примеры указания аргументов см. в разделе Определение отсутствующей информации для сигнатур MATLAB.

Поиск в файле определения для setMat метод и раскомментируют определяющие его операторы. Для определения src аргумент, в этом defineArgument оператор, заменить <SHAPE> с "len".
```
defineArgument(setMatDefinition, "src", "clib.array.matrixOperations.Int", "input", "len");
```
В методе getMat, определите RetVal вывод путем замены <SHAPE> с "len".
```
defineOutput(getMatDefinition, "RetVal", "int32", "len");
```

В методе copyMat, определите dest аргумент заменой <SHAPE> с "len".

defineArgument(copyMatDefinition, "dest", "clib.array.matrixOperations.Int", "input", "len");

В функции addMat, определите mat аргумент в функции addMat заменой <SHAPE> с 1.
```
defineArgument(addMatDefinition, "mat", "clib.matrixOperations.Mat", "input", 1);
```

В функции updateMatBySize, определите arr аргумент заменой <SHAPE> с "len".

defineArgument(updateMatBySizeDefinition, "arr", "clib.array.matrixOperations.Int", "input", "len");

Сохраните и закройте файл определения.

Проверить библиотеку

definematrixOperations;

Просмотр функциональных возможностей

summary(definematrixOperations)

MATLAB Interface to matrixOperations Library

Class clib.matrixOperations.Mat

  Constructors:
    clib.matrixOperations.Mat()
    clib.matrixOperations.Mat(clib.matrixOperations.Mat)

  Methods:
    setMat(clib.array.matrixOperations.Int)
    int32 getMat(uint64)
    uint64 getLength()
    copyMat(clib.array.matrixOperations.Int)

  No Properties defined

Functions
  int32 clib.matrixOperations.addMat(clib.matrixOperations.Mat)
  clib.matrixOperations.updateMatByX(clib.matrixOperations.Mat,int32)
  clib.matrixOperations.updateMatBySize(clib.matrixOperations.Mat,clib.array.matrixOperations.Int)

Создание интерфейса и добавление к пути MATLAB

build(definematrixOperations)

Building interface file 'matrixOperationsInterface.dll'.
Interface file 'matrixOperationsInterface.dll' built in folder 'C:\Users\matrixOperations'.
To use the library, add the interface file folder to the MATLAB path.

Щелкните значок interface file folder для добавления интерфейса к пути. Либо введите:

addpath('matrixOperations')

Просмотреть справку

В командной строке MATLAB отобразите справку по интерфейсу. Введите эту команду для загрузки пакета.

doc clib.matrixOperations.Mat

Чтобы отобразить элементы пакета, введите:

doc clib.matrixOperations

Чтобы отобразить подписи для функции пакета, щелкните ссылки для addMat, updateMatByX, и updateMatBySize.

Отображение информации о классе clib.matrixOperations.Matщелкните ссылку для Mat.

Функции библиотеки вызовов

Протестируйте функции интерфейса. Например, введите:

matObj = clib.matrixOperations.Mat;   % Create a Mat object
intArr = [1,2,3,4,5];
matObj.setMat(intArr);     % Set the values to intArr
retMat = matObj.getMat(5)  % Display the values

retMat = 1×5 int32 row vector    
   1   2   3   4   5

См. также

build | clibgen.generateLibraryDefinition | summary

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