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

C++ MATLAB Data API разделяемая поддержка библиотеки кода MATLAB Со строгим контролем типов

Когда создание C++ совместно использовало библиотеки из MATLAB^® функции или классы, можно предусмотреть, как представлять типы данных MATLAB в коде приложения C++ при помощи отображений стандартного и пользовательского типа данных между MATLAB и C++. Чтобы задать требования типа данных, вы используете arguments блокируйтесь в функции MATLAB или a properties блокируйтесь и arguments блокируйтесь в классе MATLAB. Например, если ваш код приложения C++ использует float тип данных, чтобы представлять действительное скалярное двойное значение, его эквивалентным представлением в MATLAB является (1,1) single {mustBeReal}.

Демонстрационная функция MATLAB с данными со строгим контролем типов

function r = stronglyTypedFun(num)
arguments
    num (1,1) single {mustBeReal}
end
r = magic(num);

Демонстрационный класс MATLAB с данными со строгим контролем типов

classdef MyPosition
    properties
        X (1,1) double {mustBeReal}
        Y (1,1) double {mustBeReal}
    end
end

Для получения дополнительной информации смотрите Отображения Типа данных Между C++ и кодом MATLAB Со строгим контролем типов.

То, когда вы компилируете функцию MATLAB со строгим контролем типов, класс или пакет, MATLAB Compiler SDK™ генерирует C++, совместно использовало заголовок библиотеки (.hpp файл) и развертываемый архив (.ctf файл). Чтобы сгенерировать заголовочный файл из командной строки MATLAB, войдите mcc команда с помощью этого синтаксиса:

mcc -W 'cpplib:<library_name>,generic' <MATLAB file(s) and/or package folder(s)> -d <output folder>

Заголовочный файл (.hpp) сгенерирован в том же месте как развертываемый архив (.ctf) в v2\generic_interface папка.

Сгенерированный заголовочный файл:

classdef MyRectangle

    properties
        UpperLeft  (1,1) shapes.MyPosition
        LowerRight (1,1) shapes.MyPosition
    end
    methods
        function R = enlarge(R, n)
            arguments
                R (1,1) shapes.MyRectangle
                n (1,1) double {mustBeReal}
            end
            % code
        end
        function R = show(R)
            arguments
                R (1,1) shapes.MyRectangle
            end
            % code
        end
    end
end

namespace shapes {
    class MyRectangle : public MATLABObject<MATLABControllerType> { 
    public:

        // constructors
        MyRectangle() : MATLABObject() {}

        // code

        // properties
        shapes::MyPosition getUpperLeft() {
            // code
        }
        void setUpperLeft(shapes::MyPosition obj) {
            // code
        }
        shapes::MyPosition getLowerRight() {
            // code
        }
        void setLowerRight(shapes::MyPosition obj) {
            // code
        }

        // methods
        matlab::data::Array show() { 
            // code
        }

        matlab::data::Array enlarge(double n) { 
            // code
        }

    };
}

Сгенерированный заголовочный файл (.hpp файл) и MatlabCppSharedLib.hpp заголовочный файл включен в код приложения C++ с помощью #include директивы. Можно затем скомпилировать и запустить приложение.

Демонстрационный фрагмент кода приложения C++

#include "MatlabCppSharedLib.hpp"
#include "output/cpp/v2/generic_interface/libshapesv2.hpp" //header file generated by mcc

int main(const int argc, char *argv[]) {
    try {
        // common starter code that can apply to any application
        auto mode = matlab::cpplib::MATLABApplicationMode::IN_PROCESS;
        std::vector<std::u16string> OPTIONS = {u"-nojvm"};
        auto appPtr = matlab::cpplib::initMATLABApplication(mode, OPTIONS);
        std::string ctfName(argv[1]);
        auto libPtr = matlab::cpplib::initMATLABLibrary(appPtr, std::u16string(ctfName.cbegin(), ctfName.cend()));
        std::shared_ptr<MATLABControllerType> matlabPtr(std::move(libPtr));

        // application specific code that relies on the generated header
        shapes::MyPosition p1(matlabPtr);
        ...
        shapes::MyRectangle r1(matlabPtr);
        ...
    }
}

Смотрите также

arguments | properties

Похожие темы

• Создайте C++ MATLAB Data API разделяемый заголовок библиотеки от функции MATLAB со строгим контролем типов
• Создайте C++ MATLAB Data API разделяемый заголовок библиотеки от классов MATLAB со строгим контролем типов, содержавшихся в пакете
• Отображения типа данных между C++ и кодом MATLAB Со строгим контролем типов
• Валидация аргумента функции
• Функции валидации аргумента
• Проверка значений свойств
• Функции проверки свойств