主要内容

MATLAB代码生成的类定义

为MATLAB生成高效的独立代码®类，您使用类时必须与在MATLAB环境中运行代码时不同。

有什么不同 更多的信息
受限制的语言特性集。 语言的限制
有限的代码生成特性集。 代码生成特性与类不兼容
类属性的定义。 为代码生成定义类属性
句柄类的使用。

生成MATLAB处理类和系统对象的代码

句柄类析构函数的代码生成

处理代码生成的对象限制
代码生成不支持包含MATLAB句柄对象的全局变量。万博1manbetx N/A
不支持从内置MATLAB类继承。万博1manbetx 不支持从内置MATLAB类继承万博1manbetx

语言的限制

虽然为类的常见特性(如属性和方法)提供了代码生成支万博1manbetx持，但仍有许多高级特性不受支持，例如:

  • 事件

  • 听众

  • 对象数组

  • 递归数据结构

    • 链表

    • 树

    • 图

  • 构造函数中的嵌套函数

  • Overloadable运营商subsref，subsassign,subsindex

    在MATLAB中，类可以定义它们自己的subsref，subsassign,subsindex方法。代码生成不支持对这些方法有自己定义的类。万博1manbetx

  • 的空方法

    在MATLAB中，类有一个内置的静态方法，空，它将创建该类的空数组。代码生成不支持此方法。万博1manbetx

  • 下面的MATLAB句柄类方法:

    • addlistener

    • 情商

    • findobj

    • findprop

  • 的AbortSet属性的属性

代码生成特性与类不兼容

  • 可以为使用类的入口点MATLAB函数生成代码，但不能直接为MATLAB类生成代码。

    例如，如果ClassNameA是类定义，不能通过执行以下命令生成代码:

    codegen ClassNameA

  • 句柄类对象不能是入口点函数的输入或输出。

  • 值类对象可以是入口点函数的输入或输出。但是，如果值类对象包含句柄类对象，则值类对象不能是入口点函数输入或输出。句柄类对象不能是入口点函数的输入或输出。

  • 代码生成不支持处理类的全局变量。万博1manbetx

  • 代码生成不支持构造函数的多个输出。万博1manbetx

  • 不能为Simulink使用类万博1manbetx®信号、参数或数据存储内存。

  • 代码生成不支持将值类的对象赋值给不可调属性。万博1manbetx例如,obj.prop = v;在以下情况无效道具是不可调属性和v是基于值类的对象。

  • 你不能使用coder.extrinsic将一个类或方法声明为外部的。

  • 不能将MATLAB类传递给coder.ceval．您可以将类属性传递给coder.ceval．

  • 如果属性具有get方法、set方法或验证器，或者是具有某些属性的System对象™属性，则不能通过引用将该属性传递给外部函数。看到某些属性不支持传递引用万博1manbetx．

  • 的代码中使用类MATLAB函数块时，不能使用调试器查看类信息。

  • 如果一个对象具有重复的属性名，而代码生成器试图不断折叠该对象，则代码生成可能会失败。与使用时，代码生成器常量将对象折叠coder.const，或者当它是一个常折叠外部函数的输入或输出时。

    在以下情况下，子类的对象中会出现重复的属性名:

    • 子类有一个与父类的属性同名的属性。

    • 子类派生于对属性使用相同名称的多个超类。

    重复的属性名必须在多个与继承相关的类中保持一致的常量或非常量。例如，如果对象具有常量属性，则代码生成将产生错误aProp继承了aProp从一个超类aProp定义为非常数。

    有关MATLAB何时允许重复属性名的信息，请参见子类化多个类．

为代码生成定义类属性

对于代码生成，必须定义与在MATLAB环境中运行代码时不同的类属性:

  • 属性验证错误以错误消息结束模拟。要测试属性验证，最好的做法是在整个输入值范围内运行模拟。生成的C/ c++代码万博1manbetx仿真软件编码器™不检测或报告属性验证错误。

  • 定义属性后，不要为其分配不兼容的类型。在尝试增长属性之前，不要使用它。

    在为代码生成定义类属性时，要考虑与定义变量时相同的因素。在MATLAB语言中，变量可以在运行时动态地改变它们的类、大小或复杂性，因此您可以使用相同的变量来保存不同的类、大小或复杂性的值。C和c++使用静态类型。在使用变量之前，为了确定它们的类型，代码生成器需要对每个变量进行完整的赋值。类似地，在使用属性之前，必须显式地定义它们的类、大小和复杂性。

  • 初始值:

    • 如果属性没有显式的初始值，代码生成器会假定它在构造函数的开头是未定义的。代码生成器不会将空矩阵赋值为默认值。

    • 如果属性没有初始值，并且代码生成器无法确定该属性在第一次使用之前已被分配，则软件将生成编译错误。

    • 对于System对象，如果不可调属性是结构，则必须完全分配该结构。不能使用下标进行部分赋值。

      例如，对于一个不可调属性，你可以使用以下赋值:

      mySystemObject.nonTunableProperty =结构(‘基坑’,‘‘,‘fieldB’,' b ');

      不能使用以下部分赋值:

      mySystemObject.nonTunableProperty.fieldA = 'a';mySystemObject.nonTunableProperty.fieldB = 'b';

    • coder.varsize类属性不支持。万博1manbetx

    • 如果属性的初始值是一个对象，那么属性必须是常量。属性要使属性为常量，请声明常数属性。例如:

      classdefMyClass属性(常量)p1 = MyClass2;结束结束

      代码生成不支持分配给包含System对象的对象的常万博1manbetx量属性。

    • MATLAB在代码生成之前在类加载时计算类的初始值。如果在MATLAB类属性初始化中使用持久化变量，则类加载时计算的持久化变量值属于MATLAB;它不是代码生成时使用的值。如果你使用coder.target在MATLAB类属性初始化中，coder.target (MATLAB)返回真正的(1)．

  • 适应可变属性:

    • 代码生成支持值类和句柄类的上界和万博1manbetx无界可变大小属性。

    • 要生成无界的可变大小类属性，请启用动态内存分配。

    • 若要创建大小可变的类属性，请对类属性进行两次连续赋值，一次赋值给标量，另一次赋值给数组。

      classdefvarSizeProp1 <句柄属性道具varProp结束结束
      函数extFunc(n) obj = varSizeProp1;为属性分配一个标量值。obj.prop= 1; obj.varProp = 1;将数组分配给相同的属性，使其大小可变。obj.prop= 1:98; obj.varProp = 1:n;结束

      在前面的代码中，第一个赋值为道具而且varProp标量，它们的第二个赋值是赋给具有相同基类型的数组。的大小道具的上限98，使其成为一个上界的可变大小属性。

      如果n在编译时未知，obj.varProp是一个无界的可变大小属性。如果它是已知的，则它是一个上界的、可变大小的类属性。

    • 如果类属性是用可变大小数组初始化的，则该属性为可变大小。

      classdefvarSizeProp2属性道具结束方法函数obj = varSizeProp2(inVar)将传入值赋给局部变量locVar = inVar;声明局部变量为变量大小的列没有大小限制的%向量coder.varsize (“locVar”，[inf 1]，[10 0]);赋值obj.prop= locVar;结束结束结束

      在前面的代码中，不胀钢传递给类构造函数并存储在locVar．locVar被修改为可变大小的coder.varsize并赋值给class属性obj.prop，这使得属性大小可变。

      • 如果输入到函数调用varSizeProp2适应,coder.varsize不是必需的。

        函数z = structcall (n) z = varSizeProp2(1:n);结束

      • 如果的值n在编译时未知，没有指定的边界，z.prop是一个无界的可变大小类属性。

      • 如果的值n在编译时未知，并有指定的边界，z.prop是上界可变大小类属性。

  • 如果属性为常量，且其值为对象，则不能更改该对象的属性值。例如，假设:

    • obj是myClass1．

    • myClass1具有常数性质p1那是一个对象myClass2．

    • myClass2有一个属性p2．

    代码生成不支持以下代码:万博1manbetx

    obj.p1。P2 = 1;

从内置继承MATLAB不支持的类万博1manbetx

不能为从内置MATLAB类继承的类生成代码。例如，您不能为以下类生成代码:

classdefMyclass < double

此规则的一个例外是MATLAB枚举类。可以为继承自内置MATLAB类的枚举类生成代码。看到枚举的代码生成(MATLAB编码器)．