Задайте объекты как входные параметры в командной строке

Если вы генерируете код при помощи codegen, чтобы задать тип входа, который является объектом класса значения, можно предоставить объекту в качестве примера опцию -args.

  1. Задайте класс значения. Например, задайте класс myRectangle.

    classdef myRectangle
        properties
            length;
            width;
        end
        methods
            function obj = myRectangle(l,w)
                if nargin > 0
                    obj.length = l;
                    obj.width = w;
                end
            end
            function area = calcarea(obj)
                area = obj.length * obj.width;
            end
        end
    end

  2. Задайте функцию, которая берет объект класса значения как вход. Например:

    function z = getarea(r)
    %#codegen
    z = calcarea(r);
    end

  3. Создайте объект класса.

    rect_obj = myRectangle(4,5)
    

    rect_obj = 
    
      myRectangle with properties:
    
        length: 4
         width: 5
  4. Передайте объект в качестве примера codegen при помощи опции -args.

    codegen getarea -args {rect_obj} -report

    В отчете генерации кода вы видите, что r имеет те же свойства, length и width, как объект rect_object в качестве примера. Свойства имеют тот же размер и тип, как они делают в объекте в качестве примера, rect_object.

Вместо того, чтобы обеспечить объект в качестве примера, можно создать тип для объекта класса значения, и затем предоставить типу опцию -args.

  1. Создайте объект класса:

    rect_obj = myRectangle(4,5)
    
    rect_obj = 
    
      myRectangle with properties:
    
        length: 4
         width: 5

  2. Чтобы создать тип для объекта myRectangle, который имеет те же типы свойства как rect_obj, используйте coder.typeof.

    coder.typeof создает объект coder.ClassType, который задает тип для класса.

    t= coder.typeof(rect_obj)
    
    t = 
    
    coder.ClassType
       1×1 myRectangle   
          length: 1×1 double
          width : 1×1 double

  3. Передайте тип codegen при помощи опции -args.

    codegen getarea -args {t} -report

После того, как вы создадите тип для класса значения, можно изменить типы свойств. Например, чтобы сделать свойства t 16-битными целыми числами:

t.Properties.length = coder.typeof(int16(1))
t.Properties.width = coder.typeof(int16(1))

Можно также добавить или удалить свойства. Например, чтобы добавить свойство newprop:

t.Properties.newprop = coder.typeof(int16(1))

Непротиворечивость между файлом определения объекта и определения класса coder.ClassType

Когда вы генерируете код, свойства объекта coder.ClassType, который вы передаете codegen, должны быть сопоставимы со свойствами в файле определения класса. Если файл определения класса имеет свойства, которые не использует ваш код, объект coder.ClassType не должен включать те свойства. Генератор кода удаляет свойства, которые вы не используете.

Ограничения для Использования объектов как входные параметры функции точки входа

Входные параметры функции точки входа, которые являются объектами, имеют эти ограничения:

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

  • Объект не может быть глобальной переменной.

  • Если объект имеет дублирующиеся имена свойства, вы не можете использовать его с coder.Constant. Дублирующиеся имена свойства происходят в объекте подкласса в этих ситуациях:

    • Подкласс имеет свойство с тем же именем как свойство суперкласса.

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

    Для получения информации о том, когда MATLAB® позволяет дублирующиеся имена свойства, смотрите Разделение на подклассы Нескольких Классов (MATLAB).

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

Похожие темы