主要内容

MATLAB代码生成的类定义

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

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

为MATLAB句柄类和系统对象生成代码

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

代码生成的处理对象限制

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

语言的限制

虽然提供了代码生成支持类的公共特性,如属性和方法,万博1manbetx但有一些高级特性不受支持,如:

  • 事件

  • 听众

  • 对象的数组

  • 递归数据结构

    • 链表

  • 构造函数中的嵌套函数

  • Overloadable运营商subsrefsubsassign,subsindex

    在MATLAB中,类可以定义自己版本的subsrefsubsassign,subsindex方法。代码生成不支持对这些方法有自己定义的类。万博1manbetx

  • 方法

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

  • 下面的MATLAB句柄类方法:

    • addlistener

    • 情商

    • findobj

    • findpro

  • AbortSet属性的属性

代码生成特性与类不兼容

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

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

    codegen ClassNameA

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

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

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

  • 代码生成不支持将值类的对象分配到不可调优属性。万博1manbetx例如,obj.prop = v;时是无效的道具是不可调优的属性和v是基于值类的对象。

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

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

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

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

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

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

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

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

为代码生成定义类属性

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

  • MEX函数报告由于属性验证而导致的错误。只有启用运行时错误报告功能,独立的C/ c++代码才会报告这些错误。看到生成检测和报告运行时错误的独立C/ c++代码.在生成独立的C/ c++代码之前,最好的做法是在整个输入值范围内运行MEX函数来测试属性验证。

  • 定义属性后,不要给它分配不兼容的类型。在尝试增加属性之前,不要使用它。

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

  • 初始值:

    • 如果该属性没有显式的初始值,则代码生成器会假定该属性在构造函数的开始处为未定义。代码生成器不会将空矩阵作为默认值。

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

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

      例如,对于不可调优属性,可以使用以下赋值:

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

      不能使用以下部分赋值:

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

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

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

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

    • 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(不胀钢)将传入值赋给本地变量locVar =不胀钢;%声明局部变量为变量大小的列没有大小限制的%向量coder.varsize (“locVar”[正1],[1 0]);%分配值obj.prop= locVar;结束结束结束

      在上述代码中,不胀钢传递给类构造函数并存储在locVarlocVar被修改为可变大小coder.varsize并分配给班级财产obj.prop,这使得属性变量为size。

      • 如果是函数调用的输入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 <双